H3VR Custom Character Creation 
Guide 


Author: SirPotatos 
Thanks to EnginelNK for reviewing this doc and helping me to improve it! 


This guide will cover everything you need to know in order to make your own custom 
Take And Hold character for H3VR! This document will guide you through: 

e Proper character folder/file structure setup. 

e Explanations of all of the options inside the character file. 

e Show you how to add vault guns and custom sosigs to your character. 

e Explain how to properly package your character for a release on Thunderstore.io. 


If you have zero experience in custom character creation | HIGHLY recommend 
reading through this entire document first. This document can also be used for 
further reference by jumping to the section you need in the outline to the left. If the 


outline panel is not visible, then click this icon — in the top left corner of the page. 


If you have read through this whole document and something still isn’t clear, or your 
have questions, please ping me or DM me on Discord (SirPotatos). | am a member on 
H3VR (Anton’s server), H3VR Homebrew, and H3VR Modding. | would love to hear 
feedback on this guide so | can improve it! 


Common Terms 


TNHT - Shorthand for Take And Hold Tweaker, the custom character framework. 
ItemID or ObjectID (used interchangeably) - The ID name for an item in the 
game. Every spawn-able item has an ItemID. 

e Constructor - The main table in a supply room that the player buys guns/items 
from. 

e Panel - The small tables in a supply room where you can buy bigger mags, get 
more ammo, etc. 
Tokens - The currency used in TNH to buy items. 
Boxes - Breakable boxes in supply rooms that contain either health drops or 
tokens. 

e |FF- Identification Friend or Foe, codes that tell the sosigs what “teams” they are 
on. Player is on IFF 0. 


Deli - Mod loading framework that TNHT leverages. 
Thunderstore (or TS) - The website that hosts all of the H3 mods. 
https://h3vr.thunderstore.io/ 

e R2ModMan (or R2MM, or r2mm) - The primary mod manager that players use to 
install mods from Thunderstore. 

e ObjectiDs.csv (or ObjectlDs file) - One of the most important references! Lists 
every single item in the game along with its itemID and important tags. 


Prerequisites 


R2ModMan 
e Install r2modman (if you don’t already have it installed): 
https://n3vr.thunderstore.io/package/ebkr/r2modman/ 
o Follow the install instructions on the page. 
e Install TakeAndHoldTweaker if you don't already have it installed. 
0 If this is your first time installing TNHT, then launch H3 through r2mm in 
order to generate the TNHT config, then close H3. 


Visual Studio 
e Download and install Visual Studio Code (VSC) from microsoft: 
https://code.visualstudio.com/. 
o |recommend enabling the “Open with Code” option during installation. 
Then you can just right click -> Open with Code on your json files to open 
them in VSC. 
Open VSC. 
Install the JSON extension in VSC. 
m 1. Click the Extensions icon on the left sidebar. 
m 2. Search for json. 
m 3. Click install on the json extension. 


JSON 


Meezilla 


Prettify JSON 
Mohsen Azimi 


Y] ~ienaaaesane eas Json for Visual Studio Code 
o You will use VSC to open all of the json files that will be discussed later 
on. 


m Toopen a json in VSC, either drag the file into the VSC main 
window, or right click -> open with code if you enabled that option 
during install. 

m Using VSC with the json addon will highlight errors in your json 
formatting, such as incorrect brackets, missing commas, etc. 
Additionally, hitting Alt + Shift + F will automatically indent all your 
lines properly so you don't have to indent manually. 

o Install TakeAndHoldTweaker by devyndamonster. 


Search Sort Additional filters 


takeand Default Filter categories 


ra TakeAndHoldTweaker by devyndamonster 


a This is the custom character framework and MUST be installed for 
your character to work. 


Generate Important Reference Files 


e Setup TakeAndHoldTweaker (TNHT) so that it generates default character json 
files and vault json files. 
o 1. Go to r2modman (r2mm) 
o 2. Click “Config Editor” in left pane. 
o 3. Search for TNHT and click on Edit Config. 


Config editor 


Select a configuration file to edit 


Search 


[# Config editor tnht es 


Standard v 


BepInEx\config\Deli\h3vr.tnhtweaker.deli.cfg 


o 4. Enable the BuildCharacterFiles option. 


General 


BuildCharacterFiles 
If true, files useful for character creation will be generated in TNHTweaker folder 
Setting type: Boolean 


Default value: false 


e Generate the TNHT files and copy them somewhere so you can use them as 
references. 

o 1. Launch H3 and enter the TNH lobby. Make sure the loading and file 
generation is complete (there will be no white text above the leftmost 
panel). 

o 2. Exit H3 and go to your H3 folder. Right click H3 in Steam -> Manage -> 
Browse local files. 


© Hot Dogs, Horseshoes & Hand Grena: 

! Middle-earth™: Shadow of Mordo: » PLAY 
PUBG: BATTLEGROUNDS 
Satisfactory 
Satisfactory Dedicated Server Manage ae 


SteamVR 
Browse local files 


6 Tom Clancy's Rainbow Six Siege 


UNCATEGORIZED a aa 


‘oh Among Us 


o 3. Then open the TNH_Tweaker folder inside your H3VR folder. You’ll 
want to copy all of these folders and files somewhere else. These files 
are as follows: 


steamapps common H3VR >» TNH_Tweaker 


Name Date modified 


BB DefaultCharacters 1/15/2023 8:14 PM 
F DefaultSosig Templates 1/15/2023 8:14 PM 
BB GeneratedEquipmentPools 1/12/2023 8:09 PM 
BB VaultFiles 1/15/2023 8:14 PM 
B IconiDs.txt 1/15/2023 8:14 PM 
By ObjectiDs.csv 1/12/2023 4:13 PM 
B PopulatedCharacterTemplate,json 1 023 8:14 PM 

1 


/15/2023 8:14 PM 


= | Sosig!Ds.txt 


m DefaultCharacters 
mon H3VR TNH_Tweaker DefaultCharacters 


Name Date 


8 Beginner Blake.json 

=) Classic Loadout Louis.json 
iener Calico,json 
d Steak.json 

rumbly GI Grayson.json 


a 
nsite Procurement Patrice.json 


) 
U 


perator Ori.json 


F 
O 
R 


Bc 
=| 
BG 
Bo 
=| 
=| 
Bs 


icky Dicky Random,json 
oldier Of Fortune Franky.json 
B Welldone Freemeat,json 


& Zeke Zombiehunter.json 


e Character files for all the vanilla H3 TNH characters. 

e You can use them as templates for your character. 

e | recommend looking at the character that is most similar to 
what you want to make. 


m DefaultSosigTemplates 
mmon H3VR » TNH_Tweaker » DefaultSosigTemplates 


Name Date modified 


By D_Bandito.json 15 14 PM 
B D_Bos 5 4PM 
5 D_BountyHunter.json 

5 D_BountyHunterBos 

5 D_Gambler.json 

iy D_Gunfighter.json 

D_Sheriff.json 


Gladiator_Hoplite.json 
Gladiator_Maximus. 
Gladiator_Murmill 
Gladiator_Porcus.json 


Gladiator_Secutor.json 


Gladiator_Thraex.json 

5 H_BreadCrabZombie_Fast.json 

5 H_BreadCrabZombie_HEV.json 

5 H_BreadCrabZombie_Poison.json 
= H_BreadCrabZombie_Standard.json 
5 H_BreadCrabZombie_Zombie.json 
a H_CivicErection_Meathack.json 
=I H_CivicErection_Melee.json 

5 H_CivicErection_Pistol.json 

= H_CivicErection | 

B H_Obe tElite_AR2,j 

B H_Obe stSoldier_ Shotgun.json 


B H_OberwurstSoldier_SMG.json 


H Obhenwurs felts AGNadeison 2 


e Sosig files for all the vanilla sosigs. 
e You can copy one of these and modify it to create custom 
sosigs. 


m GeneratedEquipmentPools 
H3VR » TNH_Tweaker » GeneratedEquipmentPools 
Name Date modified 


B Beginner Blake.txt 

B Black Powder Billy.txt 

= Classic Loadout Louis (Lambda).txt 
B Classic Loadout Louis.txt 
B Comrade Kolbasa.txt 

B Cowwiener Calico.txt 

B Flaccid Steak.txt 

6 Great War Gunther.txt 

& Grumbly GI Grayson.txt 

B High Explosives Harold.txt 
B Highspeed Harvey.txt 

5 Hotline Heather.txt 

& John Wurst.txt 


Bm ojave Marvin.txt 

& Onsite Procurement Patrice.txt 
B Operator Ori.txt 

B PMC Pete.txt 

B Pork Unknown.ttt 


sller Richard.txt 
5 Rickier Dickier Randomer.txt 
& Ricky Dicky Random.txt 
B Rottwurst Richtofen.txt 
ci-Fi Sofia.txt 


Ss 
S 


5 
B Soldier Of Fortune Franky.txt 

e List of all pools and guns that can spawn with each 
character. 

e |t’s helpful to go back to your 
H3VR/TNH_Tweaker/GeneratedEquipmentPools folder after 
you load your character up for the first time to make sure all 


the guns are showing up in the pools as intended. 


a VaultFiles 


H3VR TNH_Tweaker VaultFiles 


FILENAMEVO2a 
FILENAME 


e Creates all the json vault files for all guns in the OLD item 
spawner vault. 

e You'll want to come back to your 
H3VR/TNH_Tweaker/VaultFiles folder if you’ve created a 
new vault file that you want to add to your character. 


a lIconlDs.txt 


= IconiDs.txt X 


#Available Icons for equipment pools 
TNH_Icon_case_small 
TNH_Icon_case_big 
TNH_Icon_pistols 
TNH_Icon_revolver 
TNH_Icon_break_action 
TNH_Icon_tube_fed 
TNH_Icon_automatic_tube_fed_shotgun 
TNH_Icon_magazine_fed 
TNH_Icon_smg 
TNH_Icon_bolt_action_pistols 
TNH_Icon_bolt_action 
TNH_Icon_assault_rifle 
TNH_Icon_battle rifle 
TNH_Icon_machinegun 
TNH_Icon_grenade_launcher 
TNH_Icon_six_shot_grenade_launcher 
TNH_Icon_rpg 

TNH_Icon_garage 
TNH_Icon_tactical 
TNH_Icon_improvised 
TNH_Icon_powerTool 
TNH_Icon_rail_adapters 
TNH_Icon_iron_sights 
TNH_Icon_foregrips 
TNH_Icon_attachable_ stocks 
TNH_Icon_flashlight 
TNH_Icon_scopes 
TNH_Icon_suppressors 
TNH_Icon_reflex_sights 
TNH_Icon_laser 
TNH_Icon_muzzle_brake 
TNH_Icon_bayonet 
TNH_Icon_underbarrel_weapons 


e List of all of the vanilla icons that can be used in supply 
points. 
e They all start with TNH_Icon_. 
e Very helpful if you don’t want to make custom icons. 
m ObjectiIDs.csv 


S| a 4 SLT | A | S| ES A | IT | ET 


= & @ R 
foeiecD. [Caeqoy Era Se ___Couly of Oisin_ Attachment Featue Fream Acton Firearm Feed Option Fring Modes Firearm Mounts Ailachmeni Mount Round Power Size (alee Handedness Melee Sivle_ Powerup Type _ Thrown Damage Type Thrown Type 
None 


ile "Omament Modem Holiday None ‘None ‘None ‘None None None ‘None Health None 
20 ‘Omament —Medem Holiday None None None ‘None ‘None None None None Heath None ‘None 
‘Omament Meda Holiday None Nona ‘None ‘None ‘None Nona None ‘None Heath None ‘None 
‘Omament — Modein Holiday None Non None None None None None Nene Health Non ‘None 
Omament — Medemn —Holiay None None None None None None None None Heath None None 
‘Omament Made Holiday None None ‘None ‘None ‘None None None None Heath None ‘None 
‘Omament Madam Holiday None None: None ‘None ‘None None None ‘None Health None ‘Nano 
‘Omament Maden Holitay None None ‘None ‘None ‘None None None ‘None Health None ‘None 
‘Omament Modem Holiday None None ‘None ‘None ‘None None None None Heath None ‘None 
‘Omament Meda Holiday None None ‘Nene ‘Nene ‘None Nona Nona ‘None Heath None ‘None 
‘Omament Modem Holiday — None None None None None None None None Health None ‘None 
Omament — Medemm Holiday None Non None None None None None None Heath None ‘None 
‘Omament Modem Holiday None None None None ‘None None None None Heath None ‘None 
‘Omamont Modan Holiday Nono None. ‘None ‘None ‘None ‘None None ‘None Health None ‘None 
‘Omament Modi — Holy lone None ‘None None None None None ‘None Health None ‘None 
‘Omament Modem Holiday None None None None None None None None Heath None ‘None 
‘Omament Madam Holiday None Nona ‘None ‘None ‘None ‘Nona None ‘None Heath None ‘None 
‘Omament Modan — Holiday None None None None None None None None Health None None 
Omament Made — Holiday None None None None None None None None Heath None None 
Real None None ‘None ‘None ‘None None None None Heath None ‘None 

Real Nono None None ‘None ‘None None None ‘None Health None Nano 

Real None None ‘None ‘None ‘None None None ‘None Health None ‘None 

Real None None ‘None ‘None ‘None None None None Heath None ‘None 

Foal Nono None ‘None ‘None ‘None None None ‘None Heath None ‘None 

Uncategorized Nowe Real None None ‘None None ‘None None None None Health None ‘None 
Uncategorized Modem Real None None ‘None None None None None None None None None 
Uncategorzed Modem Resi None None None ‘None ‘None None None None None None None 
Uncategorized Modem — Real Nono None. ‘None ‘None ‘None None None ‘None None None ‘None 
Uncategorized! Modem Real None None ‘None ‘None ‘None None None ‘None None None ‘None 
Real None None None None None None None None None None None 

Foal Nono None ‘None ‘None ‘None None None ‘None None None ‘None 

Real None None ‘None None ‘None None None None None None None 

Real None None None iN None None None None None None None 

Real None None ‘None ‘None None None None None None ‘None 

Real Nono Nano None ‘Nano ‘None None None ‘None Heath None ‘Nano 

Real None None None None ‘None None None None Health None ‘None 

Uncategorzed Nove Real None None ‘None None ‘None None None None Heath None ‘None 


e Probably the single most important file here. 


It generates a list of EVERY item in H3 that has an Item ID. 
If you want a specific item to spawn in an equipment pool, 
you will reference this file to find its item ID. 

e ltalso lists all the attributes of every item in case you are 
making auto-populated pools. This is explained in the 


Equipment Pool Setup section below. 


ObjectlIDs.csv 


e You will want to open the ObjectlDs.csv file in a spreadsheet software such as 
Excel, or LibreOffice Calc. 
o If you don’t have Microsoft Office (Excel) then download LibreOffice from 


here: httos:/Awww.libreoffice.org/ 
e When you open it it may ask you something like this: 


Import 


Character set: |Western Europe (Windows-1252/WinLatin 1) |v 


Language: Default - English (USA) v 


™ 


From row: 1 a 
Separator Options 
O Eixed width © Separated by 
Tab Comma Semicolon (L] Space OO Other 


O Merge delimiters 1 Trim spaces String delimiter: |"|¥ 
Other Options 
(] Format quoted field as text (J Detect special numbers 
Fields 


——— eer 


|Standard Standard |Standard |Stand a 
Category Era Set couni 
Ornament Modern Holiday None 
Ornament Modern Holiday None 
Ornament Modern Holiday None 
Ornament Modern Holiday None 
Ornament Modern Holiday None 
Ornament Modern Holiday None 
Ornament Modern Holiday None ,, 


> 


Help => OK Cancel 


o Just hit OK to import the csv. 


e It’s very helpful to auto-filter the file. Do this by clicking the V AutoFilter ion, 


Excel has a similar funnel icon. 


e Your column names will now have little arrows you can click to filter the various 
item tags. 


A 5 cL v | ct ls ov n ' 

“lObjectID Fplcsesen lea else [=] Country of Ong Attachunent Foal Freon Ato Firearm Feed Opie Firing Modedis|rreamn 
_ |BulbBlue A Omament Modern Holiday None None None 
_|BulbGreen Ormament Modern Holiday None None None 
_|Bul Ormament Modern Holiday None None None 
_|BulbPink Omament Modern Holiday None None None 
_|BulbPurple Omament Modern Holiday None None None 
_ |BulbR Omament Modern Holiday None None None 

BulbWhite Ormament Modern Holiday None None None 


o Filtering can be useful to figure out what tags will spawn what items. 
o Ex: Try filtering the following: 

= Category: Firearm 

m Era: Modern 

m Set: GroundedFictional 

m= Your result should look like this: 


A B D 

1__|ObjectID case Era Set Cc 
2219 _|Deaglov Firearm Modern Grounded* Ur 
2239 _|gl Firearm Modern Grounded*Ur 
2246 _|Il Firearm Modern Grounded*Ur 
2319 _|Kuulanisku Firearm Modem Grounded? Re 
2605_|MosinMini Firearm Modern Grounded* Ur 
2641_|M1600A3000 Firearm Modern Grounded> Nc 
2650_|MauserAssaultCarbine Firearm Modern _Grounded* Ki 
2717__|FourLetterWord Firearm Modern Grounded* Ki 
2733_|1887ShortyT2 Firearm Modern Grounded* Ur 
2737_|CAWS_TacMod Firearm Modern Grounded> W. 
2739_|KWG1 Firearm Modern Grounded*Rt 
2942 _|PPSh41Modern Firearm Modern Grounded*Rt 
3092__|M2Tombstone Firearm Modern Grounded*Ur 
3097__|Mk19 Firearm Modern Grounded Ur 
3099 _|STENOF Firearm Modem — Grounded? Ki 
3106 _|JunkyardFlame Thrower Firearm Modern _Grounded® Ur 
3115_|PotatoGun Firearm Modern Grounded* Ur 


= So if you make an equipment pool with these three tags, your pool 


will contain all of these weapons! Equipment pools are explained in 
depth below. 
e The ObjectID column tells you the exact ObjectID (or ItemID) that you can use to 
spawn a particular weapon in an equipment pool. 
e Anytime Anton adds new items or you install a new mod, a new ObjectIDs.csv 
will be generated in H3VR/TNH_Tweaker after you launch H3 and open the TNH 
lobby with the content installed. 


Initial Character Setup 


Template Character 


e A template character is available to download here: 


https://drive.google.com/file/d/10EK2pAakmpp qUHdChMuHOkriG290tBB/view? 
usp=sharing 


e This template already has a manifest and an example of each type of file already 
in it. The file structure is also already correctly set up for you. 

e |recommend downloading the template character zip file, and unzipping it in a 
good location for you to work out of. If you download it first you can follow 
along with this guide. 

All examples in this guide exist inside this template character. 
You should backup all your character files on Google Drive or Git or 
something! You will be very sad if you accidentally delete/lose it! 


Proper Folder Structure 


For your first character you should use this folder structure as shown. 
Top-level TemplateCharacter folder. (contains only a manifest.json and a 
subfolder) 


odding » TNHTweaker » TemplateCharacter 


Name Date modified Type 


7h lemplateCharacterSubfolder if 746 AN File folder 


Al manifest.json 7/2023 7:48 AN JSON File 


Hding » TNHIweaker >» TemplateCharacter » TemplateCharacterSubfolder 


Name Date modified Type 
Oh sosigs 23 7:49 AN File folder 


FW vault 1/6 5 PV File 


AA character.json 1/9 NV JSON File 


4 ExampleSupplyPointlcon.png 6 45 AN PNG File 


o> | thumb.png 1/7/2023 7:46 AM PNG File 


sosigs folder (contains your custom sosigs) 
TemplateCharacter >» TemplateCharacterSubfolder sosigs 


Name Date modified 


Zi sosig_ExampleCustomSosig.json 
2 P 9J 


ding » TNHIweaker » TemplateCharacter >» TemplateCharacterSubfolder » vault 
Name Date modified 


v, | vault_ExampleVaultGun.json 


Folder Tree (visual diagram of the above folder screenshots) 


manifest.json 


thumb.png ~~ ExampleSupply ExampleSupply character.json 
Pointicon1.png Pointilcon2.png 


ExampleCustom ExampleCustom ExampleVault ExampleVault 
Sosig1.json Sosig2.json Gun1.json Gun2.json 


You should change TemplateCharacter and TemplateCharacterSubfolder to 
be the name of your character. 

o | recommend avoiding spaces in these folder names. You can use ‘_’ if 
you like instead. 

o You will need to update the paths to the subfolder in the manifest.json 
after you change the name of the TemplateCharacterSubfolder. This is 
explained in the next section. 

All custom supply point icons should be placed in the 
TemplateCharacterSubfolder. 


e sosigs 
oO 
[@) 


(2) 


This is a folder that contains your custom sosig files. 
All custom sosig files must be placed inside the sosig folder or they will not 
load properly! 
If you don’t want to make any custom sosigs and just want to use the ones 
Anton has already created, then you can just delete this folder. 

a If you delete this folder you must also modify the manifest. 

This is discussed in the next section. 

This folder is OPTIONAL. 


e vault 

o This is a folder that contains your vaulted gun files that you want to spawn 
in your character. 
All vault files must start with “vault_” 
If you don’t want to use custom vault guns in your character then you can 
delete this folder. 

a If you delete this folder you must also modify the manifest. 
This is discussed in the next section. 
o This folder is OPTIONAL. 
Manifest Setup 


e Manifest.json contains info about your mod, and also points deli to all the 
relevant files that need to be loaded. 

e This manifest is your “Deli manifest’. This is not to be confused with your 
Thunderstore manifest which is also called “manifest.json” but looks completely 
different on the inside. 


12) 


Thunderstore manifests will be covered at the end of this guide, don’t 
worry about them right now. 


e To setup your manifest follow each of the steps in the picture below: 


son X n 
manifestjson 1. Change “templatecharacter” to the name of your character. 


Do NOT use spaces, capitals, or special characters. 


2. | leave 0.0.0 as version number until release, at 
which point you should change it to 1.0.0. 


“require” 
“dependencies” 

“h3vr.tnhtweaker.deli” 3. Change to the name of your character. Can have 
spaces if you with. 
“name” 

“description” 
“source_url’ 


“authors” 4. Change to a short description of your character. 


“assets” 5. Change to your name. 
“patcher" 
“setup” 

“Temp lateCharacter 

“TemplateCharact der/vault/*.js 

“TemplateCharacterS: lder 


seagate tn” 6. If you deleted the sosig and/or vault folders because you 
aren't going to use them, you must delete line 17 and/or 18. 


7. These are paths to your character's subfolder. They tell TNHT where your custom 
sosigs (line 17), vault files (line 18), and character.json (line 19) files are located. 
After you've renamed the subfolder in the previous section, make sure to update 
these paths to match your new subfolder name or your character won't load! 


e Example of a manifest for a character that has no custom sosigs or vault files: 


manifestjson @ 


“guid”: 

“version” 

“require” 

“dependencies” 
“h3vr.tnhtweaker.deli” 


“name” : 


“description” 
“source url” 
“authors” 


], 
“assets” 
“patcher”: {}, 
“setup”: { 
“Temp lateCharacterSubfolder/” 
}, 


“runtime” 


Thumbnail Setup 


thumb.png is a square thumbnail that shows up on the TNH selection screen. 

It must be a PNG and it must be named thumb.png exactly. 

You'll want to swap this out for a better thumbnail before you release your mod, 
but my amazing stick figure drawing will work fine for testing. 

Can be any resolution, but doesn’t need to be too big to look good. 

This file is REQUIRED. 


Custom Supply Point Icons 


e If you don’t want to use Anton’s built-in supply point icons (the basic looking 
white profiles of different gun types) then you can create your own supply point 
icons as PNGs and drop them into the TemplateCharacterSubfolder. 

e They should be squares, but can be any resolution. Though the resolution 
doesn't need to be too high in order to look good. 

Keep in mind that the token cost overlaps the bottom edge of the icon slightly. 
How to use these custom icons is explained in the Equipment Pools section 
below. 


Character File Setup 


e This is your main character file where you will define all the equipment pools 
(what items can spawn), how much everything costs, what sosigs and how many 
spawn, holds, etc. 

You'll spend most of your time editing this file. 

The details of this file are outlined here. This file is VERY complicated! 

Before you begin modifying this file, please read through this whole section and 
scroll through your Template Character’s character.json file to follow along as 
well. 

e All of the options and settings will be explained in detail. It’s important to 
understand what they all do so you don't get undesirable results. 

e When you are first learning, ONLY change a few things at a time before you 
build and test! Frequent testing will pinpoint what you are doing wrong and 
then you only have to undo a couple things instead of having to start from 
scratch if your character won’t load or breaks. 

e When you are ready to make your own character, it’s best to copy one of the 
default character files. 

1. Decide which vanilla character is closest to your character in terms of 
guns that spawns, and in terms of what enemies you'll face. 

2. Copy that character’s file from the H3VR/TNH_Tweaker/DefaultCharacters 
folder. 

3. Rename it to character.json and replace the character.json file in your 
TemplateCharacterSubfolder. 


Global Settings 


e Follow the steps below to setup the character.json for your character. 


1, Change “Template Character" to the name of your 
nal character. It's ok to use spaces here. 


2. Write a short description of your character. This will show up in the character selection 
screen in the TNH Lobby. You can force text to wrap to a new line by putting \n in the string. 


3. Set the CharacterGroup. 0 - to show up in Daring Defaults. 1 - to show 
up in Wieners Through Time, 2 - to show up in Memetastic Meats. 


4. Set the TablelD. Generally just use your character's name without any spaces. 
If you had the same TablelD as another character there probably will be problems 
with the score tables. Make sure this is unique! 


e The other settings here can be changed to true or false based on what you want 
for your character. 


(0) 


StartingTokens - Self-explanatory, it’s the number of tokens the player 
starts with before any holds. 
ForceAllAgentWeapons - | *think* this means sosigs will spawn with all 
available weapons? | have never used it, and should just leave it as false. 
Please contact me to update this document if you figure out what this 
setting does. 
ForceDisableOutfitFunctionality - If “true” then sosig outfits that have 
special functionality will not use that functionality. Ex. for John Wurst | 
wanted to use the Meat Fortress Spy’s balaclava. Unfortunately that 
balaclava allows sosigs to turn invisible at will! So, by setting this to “true” 
the balaclava no longer turned sosigs invisible. 
UsesPurchasePricelncrement - If “true” the cost of buying a particular item 
from the supply point will increase by 1. This prevents the player from 
buying the same 1 token pistol 100 times and reselling it for 1 token until 
they get the exact gun they want. 
HasPrimaryWeapon, HasSecondaryWeapon, HasTertiaryWeapon - These 
simply enable or disable the primary/secondary/tertiary starting weapon 
pools that are defined lower down. 

mu Primary always spawns in a large crate. 

m Secondary always spawns in a small crate. 

m Tertiary never spawns in a crate. 
HasPrimaryltem, Has SecondaryWeapon, Has TertiaryWeapon - These 
simply enable or disable the primary/secondary/tertiary starting item pools 
that are defined lower down. 

= None of these spawn in crates. 
HasShield - Simply enables or disables the starting shield pool that is 
defined lower down. 


Valid Ammo and Blacklists 


e These lists allow or restrict different types of ammo and magazines from 
spawning. 


characterjson 


e ValidAmmoEras 
o These are the eras of ammo that are allowed to spawn. 
o If you were to remove WW2 from that list then WW2 guns would not be 
able to get any ammo from the ammo panel, for example. 
Leaving it set to the default list is usually just fine. 
The full list of AmmoEras is as follows: 
= Colonial 


WildWest 
TurnOfTheCentury 
WWw1 

WWw2 

Medieval 

PostWar 

Modern 

= Futuristic 


e ValidAmmoSets 


(2) 


oO 
12) 


These are the ammo sets that are allowed to spawn. 
Mostly used for restricting meme/non-lethal ammo from spawning. 
The full list of AmmoSets is as follows: 
m Real 

= GroundedFictional 
m SciFiFictional 
= MeatFortress 
= Meme 

e Ex: 50 Imaginary, 45 ACP Oversize 
= NonCombat 

e Ex: 12ga Cannonball, 12 Ga Freedomfetti, and 40mm 

Practice Round 


e GlobalAmmoBlacklist 


oO 
oO 


Used to prevent specific cartridges from ever spawning. 

In the example above, I’ve added all 12 Ga rounds so that ONLY 00 
bukshot and slugs will spawn. 

For this list, you add in the item ID of the cartridge, which can be found in 
the ObjectlDs.csv file that you copied from your H3VR/TNH_Tweaker 
folder at the beginning of this guide. 

If you want these 12ga rounds to spawn and you’re using my 
Template Character make sure to delete the entries from this list! 
This is where you would blacklist ammo mods like Exotic 12ga. You need 
to find the itemIDs in your ObjectIDs file for the mod ammo and add to the 
blacklist. 


e MagazineBlacklist 


(2) 


10) 


Prevents specific magazines from spawning with certain firearms. 

To add more gun/magazine combos to the blacklist, simply copy 
everything between the { } (including the { }) and copy it down right below 
the closing } with a comma in between them. 


o For this list, you add in the item ID of the guns and mags, which can be 
found in the ObjectIDs.csv file that you copied from your 
H3VR/TNH_Tweaker folder at the beginning of this guide. 

o Clips can also be blacklisted as well in the ClipBlacklist below the 
MagazineBlacklist. 

o You can blacklist mags for mod guns as well. If the player doesn’t have 
that mod installed it doesn’t break anything. 

o Inthe example above, the ModularMPxX is prevented from spawning with 
Scorpion Evo mags. The author of the ModularMPX mod made scorpion 
mags cross-compatible. And | wanted to make sure that only the proper 
MPX mags would spawn, so | blacklisted all 3 vanilla Evo mags in addition 
to a modded 40rnd Evo mag that Andrew had added. 


Required Sight Table 


e Many modern guns in H3 only have picatinny rails and no built-in iron sights. As 
a result, in TNH they need to spawn with sights. 


e The default setup is to spawn a picatinny red dot for any gun that requires a 
sight. 


characterjson X 


“RequireSightTable”: 
“Category”: 
“Rarity”: 
“RequiredQuest”: 
“ItemsToSpawn"™: 6, 
“MinAmmoCapacity”™ : 
“MaxAmmoCapacity” : 
“NumMagsSpawned™: -1, 
“NumClipsSpawned”: -1, 
“NumRoundsSpawned”™ : 
“SpawnMagAndClip”: false, 
“BespokeAttachmentChance” : 
“IsCompatibleMagazine”: false, 


, 


“AutoPopulateGroup™: true, 
“ForceSpawnAllSubPools”: false, 
“IDOverride”: [], 

“Eras”: [], 

“Sets”: [ 


“Sizes”: [], 
“Actions”: [], 
“Modes”: [], 
“ExcludedModes”: [], 
“FeedOptions”: [], 
“MountsAvailable”: []}, 
“RoundPowers”: [], 
“Features”: [ 


] 


eleeStyles”: [], 
“MeleeHandedness”: [], 
“MountTypes”: [ 


“Poweruplypes”: [], 
“ThrownTypes”™: [], 
“ThrownDamageTypes”: [], 
“SubGroups™: [ | 


e Inthe default setup, any attachment in the game that is marked as “Real”, has 
the “Reflex” feature, and has a “Picatinny” mount type will soawn with guns that 
requie sights. 


This pool can technically be modified to spawn any item in the game. More 
details on how to modify these “EquipmentPool” tables will be explained in the 
Equipment Pools section below. 

If you want a pair of iron sights to spawn instead of a reflex sight then replace 
“Reflex” with “lronSight”. 

This table cannot be empty! 

o So if you don’t want any sights to spawn you gotta put something in here 
still. 

o For example, on John Wurst, Pork Unknown, and Rainbow Six Steve, any 
gun that needs a sight | have already made vault files for and put iron 
sights on those guns. 

So, what | did for those characters was set AutoPopulateGroup to false. 
Then | put rail hats in the IDOverride list like so: 


Starter Weapons And Items 


e There are 7 different starting equipment pool tables that you can utilize. 
Each of these tables are labeled as follows: 


(0) 


oOo 0 0 0 


10) 


Each of these 7 tables can be turned on/off using the options in the Global 


PrimaryWeapon - Item spawns in a long orange crate. 
SecondaryWeapon - Item spawns in a small orange crate. 
TertiaryWeapon 

Primaryltem 

Secondaryltem 

Tertiaryltem 

Shield 


Settings section above. 


Despite their labels, technically any of these 7 tables can spawn any type of item 
in the game, you don’t have to only spawn weapons from the weapon pools. 
The example below only shows the PrimaryWeapon and Primaryltem tables, but 


all tables have the exact same options. 


characterjson X 


} 
le 


“PrimaryWeapon" : 
“PrimaryGroup”: { 

“Category”: 
“Rarity”: 1.0, 
“RequiredQuest™: null, 
“ItemsToSpawn": 6, 
“MinAmmoCapacity” : 
“MaxAmmoCapacity”™: 
“NumMagsSpawned™: 3, 
“NumC lipsSpawned” : 
“NumRoundsSpawned": 6, 
“SpawnMagAndClip”: false, 
“BespokeAttachmentChance” : 
“IsCompatibleMagazine”: false, 
“AutoPopulateGroup”™: true, 
“ForceSpawnAllSubPools”: false, 
“IDOverride” : 
“Eras”: P 
“Sets”: 


"Actions": 


“Modes”: : 
“ExcludedModes” : 


“FeedOptions”: P 
“MountsAvailable”: 
“RoundPowers” : 


“Features”: 
“MeleeStyles”: - 
“Me leeHandedness” : 
“MountTypes” : 
“PowerupTypes”: 


“ThrownTypes” : . 
“ThrownDamageTypes” : 
“SubGroups” : 


), 


characterjson @ 


Users > 


For this Template Character, he will start with a semi-automatic pistol (that does 
not have full auto) and will receive 3 magazines for it that have a capacity of 5 to 
12 rounds. 

o This pistol will spawn in a long orange crate. 
The character will also receive a Health sausage as well. 
More details on how to modify these “EquipmentPool” tables will be explained in 


the Equipment Pools section below. 


Equipment Pool Setup 


e It is so important for you to fully understand how equipment pools work 
before trying to create your own. 


Equipment Pools Explained 


e Equipment Pools are tables in the character.json that dictate what spawns, how it 
spawns, what it spawns with, etc. 
e There are 2 primary ways that items are added to equipment pools: 
AutoPopulateGroup and |IDOverride. 
o AutoPopulateGroup 

m This is the way that all of Anton’s vanilla characters work. 

m The equipment pool is given a set of parameters that are used to 
filter through all of the items in the game and only allows items that 
match all the given parameters to spawn from that pool. 

m Auto-population has the benefit of adding any new guns as they are 
added to the game through Anton or mods. 

o IDOverride 

mu This is a simpler way to add items to an equipment pool that gives 
you complete control over what items can spawn from it. 

m You simply put in a list of all the Item IDs that you want to be in the 
pool. 

e You can obtain the ObjectlDs.csv list by following the steps 
in the prerequisites. 

m= The downside is that if new guns are added through Anton or mods 
you’d need to manually update this list to add them. 


o An example of these two pool setups are given below: 


Auto-populated Group IDOverride Group 


characterjson characterjson 


equipmentroo.is 


{ 
t e . 
IconName 


type “TokenCost” 
“IconName™” 


“TokenCost” 
“TokenCostLimited™ 


“TokenCostLimited” 
“MinLeve lAppears” 
“MaxLeve lAppears” 
“MinLeve lAppe pawns InSmal lCas 
“MaxLeve lAppears” pawns InLarget 
“SpawnsInSmallca 
“SpawnsInLargeCa 
“PrimaryGroup” 
“Category “RequiredQuest” 

“Items ToSpawn 
“MinAmmoCapecity” 
“MaxAmmoCapac ity 
"Mi nAmmoCapac “Numhtogs Spawned 
“MaxAmmoCapac i Nua 1 ipsSpawne 
“NumMags Spawned” 


“Nua lip 


“NumRoundss 
awnMa gana 


“NumRour paw ,OkKeATtachmentChance” 
2 oun >a! 7 
TsCompat ible azine”: fa 
pawnMagAndac lip 7 
- nt AutoPopu lateGrour 
BespokeAtt achmentChance a = 
ForceSpawnAl 1SubPools 
“IsCompatibleMagazine™: f = a 
1DOverride i 
“AutoPopu lateGroup" 


This pool will 
only contain 
these 3 guns. 


“ForceSpawnAl lSubPool 
“TDOverr ide" 


“Eras” 


This pool 
_— . , 
will contain 
any gun that 
matches all 
tions? + these 
“parameters. 


“Stres" 
“Actions” 

“Mod F 
“ExcludedMox 
“FeedOptions t 
“Mount sAvai lable” 
“RoundPowers” 
“Feature 
“Meleestyl 


“Modes ; 
emery Weies Me leeHandedness 


“FeedOptions™ 
“Mount sAvai lab] 


“Mount Types” 
“PowerupType 
“ThrownTyp 
“ThrownDamageTypes™ 
“SubGroups” 


“RoundPowers 


“Feat 
“Meleestyl 

“Me leeHandedness”™ 
“Mount Types” 
“PowerupTypes™ 
“ThrownTyp 
“ThrownDamage Types” 
“SubGroups™ 


“BackupGroup™ 


Equipment Pool Parameters 
e There are two “sections” to an equipment pool. 


e The first section is important details on when/how the equipment pool shows up 
in the supply points. 


characterjson X 


“EquipmentPools™ 


“Token 

“Mintevel 
“Maxt eve lAppears” 
"Soawns InSaal lCase 


“Spawns InLargeCase 


AutoPopul ateGr 
“ForceSpawnAl 1 SubP 


“IDoverr ide” 


SubGroups 


“BackupGroup™ 


o Type - This just determines where on the supply point constructor this pool 
can show up. 

Locomotion - First icon on the supply constructor . 

Firearm - Second on the supply constructor . 

Equipment - Third icon on the supply constructor . 

Consumable - Fourth icon on the supply constructor . 

Storage - Fifth icon on the supply constructor . 


Equipment Consumable Storage 
Firearm 


Locomotion 


o IconName - This is the icon that will appear for this pool on the supply 
panel. 
m You can either use Anton’s default icons. 
e The complete list of Anton’s vanilla icons can be obtained by 
following the instructions in this section to obtain the 
Icon|Ds. txt. 
e Anton’s icons all start with TNH_Icon_. 
m= Or you can use custom icons. 
e These icons must be PNGs that are located in the 
CharacterSubfolder. 
e Simply put the entire file name (including the file extension) 
of the png in IlconName. 


o Ex: The TemplateCharacter uses 
“ExampleSupplyPointlcon.png’” on line 429 which is a 
picture of a 1911. 
TokenCost - Self-explanatory, this is the cost for the player to buy this 
pool. 
TokenCostLimited - This is the cost if the player is playing on limited 
ammo. 
m Ex: A spawn-lockable grenade can be extremely powerful in TNH. 
So maybe this is worth 5 tokens. However, in Limited Ammo, you'll 
only get 1 use, so maybe you want that to cost only 1 token 
instead. 
MinLevelAppears - The minimum TNH level that this pool can show up at. 
= Must be 0 or greater. 
m lf this pool can show up before the first hold starts then you should 
use 0. 
MaxLevelAppears - The maximum TNH level that this pool can show up 
at. 
= Must be 0 or greater. 
a If you want a pool to only show up for one level, like between hold 1 
and 2, then you would set MinLevelAppears and MaxLevelAppears 
both to 1. 
SpawnsInSmallCase - If set to true then the item will spawn in a small 
orange case. 
SpawnslInLargeCase - If set to true then the item will spawn in a large 
orange case. 
m If both the above options are set to false, then the item will just 
spawn on the supply point table directly. 


e The second section is what defines what objects will appear in this equipment 
pool. 


characterjson X 


o Category - This is only used if you are auto-populating groups. 


m Categories include Firearm, Attachment, Powerup, Uncategorized, 
Magazine, etc. 

m The ObjectlDs.csv file can tell you what each item’s category is. 
Rarity - This determines the probability of this pool appearing at the supply 
point. 

m Higher values mean the pool is more likely to show up. 

m= The rarities scale linearly. le. that a pool with rarity 2 is twice as 
likely to show up as a pool with rarity 1. 

m Ex: If you have a pool with a rarity of 99 and another pool with a 
rarity of 1 that both show up during Level 0, and they both show up 
on the Firearm tab of the supply point table, then you'll almost 
never see the pool with rarity 1. 

RequiredQuest - I’ve never used it, and have no idea how it works. Will 
update if | find out. 
Items ToSpawn - Determines the number of items to spawn from this pool. 

= Ex: 1 set this to 2, then for spending 3 tokens on this | would get 2 
random semi automatic pistols, not necessarily the same one twice. 

MinAmmoCapacity - The minimum ammo capacity of the gun or the mags 
that spawn with the gun. 

m Ex: This pool would spawn a pistol with mags that are 15-20 
rounds. 

NumMagsSpawned - If the gun that spawns takes magazines, then this 
determines how many mags to spawn. 

= Default is 3. 

NumClipsSpawned - If the gun does not take mags, but does take clips 
(for example the Kar98k) then this determines how many clips the gun will 
spawn with. 

m Speedloaders count as “clips”. / think. 

NumRoundsSpawned - If the gun does not take mags or clips, this 
determines how many rounds to spawn with the gun. 

= Most commonly kicks in for tube magazine shotguns, break actions, 
revolvers with no speedloaders, etc. 

= Default is 6. 

SpawnMagAndClip - If true, then a gun that takes both mags and clips (for 
example the Lee Enfield and SKS Modern) would spawn with both. 

= Ex: if set to true, this pool would spawn 3 mags and 3 clips for the 
SKS Modern. 

BespokeAttachmentChance - Probability that the gun will spawn with a 
bespoke item. 

m Should be between 0 and 1, 1 being 100% chance. 


m Ex: If set to 1, then the SVT40 would spawn with either its bespoke 
scope, or its bespoke bayonet, but not both. 

o IsCompatibleMagazine - If set to true, then this entire table is overridden 
and it will instead just spawn a magazine that is compatible with a random 
gun in your quickbelt or hands. 

m The Min/Max ammo capacity is used to determine which mags can 
spawn. 

o AutoPopulateGroup - If set to true, then the group is auto-populated with 
items based on the following parameters. Use your ObjectIDs.csv file to 
see what guns fit each of these parameters. 

m Category 
e This parameter is relevant to all items. 
e Options: 
o Attachment 

Cartridge 

Clip 

Explosive 

Firearm 

Firework 

Loot 

Magazine 

MeleeWeapon 

Ornament 

Powerup 

SosigClothing 

SpeedLoader 

Target 

Thrown 

Tool 

Toy 

Uncategorized 


Or 'O2 “Or 'Or WO (Or GO Or Qs Or OQ. Onc. Or (Or Os 


m Eras 
e This parameter is relevant to most items. 
e Options: 
o Medieval 
Colonial 
WildWest 
TurnOfTheCentury 
ww1 
WW2 


OO. O. Or °O 


= Sets 


Oo. OF O° <0 


PostWar 
Modern 
Futuristic 
None 


e This parameter is relevant to most items. 
e Options: 


= Sizes 


10) 


oOo 0 00 0 


Real 
GroundedFictional 
SciFiFictional 

MF 

NonCombat 
Meme 

Holiday 


e This parameter is relevant to firearms. 
e Options: 


= Actions 


Oo O-'@. Or Oe Ov GO 


Pocket 
Pistol 
Compact 
Carbine 
FullSize 
Bulky 
Oversize 
None 


e This parameter is relevant to firearms. 
e Options: 


= Modes 


10) 


000000 0 0 0 0 


Automatic 
BoltAction 
BreakAction 
LeverAction 
OpenBreach 
PreLoaded 
PumpAction 
Revolver 
RollingBlock 
SingleActionRevolver 
None 


This parameter is relevant to firearms. 
Fire modes listed here will filter for guns that have at least 
one of the listed fire modes. 
e Options: 
o SingleFire 
o SemiAuto 
o Burst 
o FullAuto 
ExcludeModes 
e This parameter is relevant to firearms 
e Fire modes listed here will be excluded from the gun. If you 
list FullAuto here, then the guns in the pool cannot have a 
FullAuto fire mode. 
e Options: 
o SingleFire 
o SemiAuto 
o Burst 
o FullAuto 
FeedOptions 
e This parameter is relevant to firearms 
e tis the method by which the firearm loads rounds. 
e Options: 
o BoxMag 
BreachLoad 
EnblocClip 
InternalMag 
StripperClip 
o None 
MountsAvailable 
e This parameter is relevant to firearms 
e tis the types of mounts that are on the gun. 
e Options: 
o Bespoke 
Muzzle 
Picatinny 
Stock 
Russian 
RoundPowers 
e This parameter is relevant to firearms, cartridges, and 
magazines. 


Or. OF 30° “© 


oO 
10) 
oO 
oO 


e Options: 


(2) 


O° OO. (Or Oo Or tOo -O 


= Features 


Tiny 

Pistol 
Intermediate 
FullPower 
Shotgun 
AntiMaterial 
Ordnance 
Exotic 

None 


e This parameter is relevant to attachments. 
e It explains what type of attachment it is. 
e Options: 


10) 


©: #0: Or "Or 30 OP Os 3Or (Os O» YO. “OF (OO) 


12) 


m MeleeStyles 


Adapter (this means rail adapters) 
BarrelExtension 

Bayonet 

Bipod 

Decoration 

Grip 

Illumination 

lronSight 

Laser 

Magnification 

ProjectileWeapon 

RecoilMitigation (this means muzzle brakes) 
Reflex 

Stock 

Suppression (this means suppressors) 
None 


e This parameter is relevant to melee weapons. 
e This is the “class” of melee weapon. 
e Options: 


OQ “Or: Or “O 


Medieval 
Improvised 
Tool 
PowerTool 
Tactical 
Shield 


10) 


None 


MeleeHandedness 
e This parameter is relevant to melee weapons. 
e This parameter explains if the weapon is meant for 
one-handed or two-handed use. 
e Options: 


12) 


OneHanded 


o TwoHanded 


MountTypes 


e This parameter is relevant to attachments. 

e This parameter explains how the attachment attaches to a 
weapon. 

e Options: 


oO 
oO 
oO 
oO 
oO 


(2) 


Bespoke 
Muzzle 
Picatinny 
Russian 
Stock 
None 


PowerupTypes 
e This parameter is relevant to power up sausages. 
e Options: 


12) 


Or “OO -'O! “Oo “Ob “Or. “Or 30 


(0) 


ThrownTypes 


Health 
Regen 
Invincibility 
InfiniteAmmo 
MuscleMeat 
QuadDamage 
GhostMode 
Cyclops 

Blort 
FarOutMeat 
SnakeEye 


e This parameter is relevant to thrown items, such as 
grenades. 
e Options: 


12) 
oO 
oO 


ManualFuse 
Pinned 
Strange 


o None 
= ThrownDamageTypes 
e This parameter is relevant to thrown items, such as 
grenades. 

e Options: 
o Explosive 
o Fire 
o Kinetic 
o Utility 
o None 

o All parameters must be met by an object in order for it to be added to an 
auto-populated loot pool. 


Backup Groups 


e Backup groups can be created by simply copying the PrimaryGroup (everything 
between and including the { }) and pasting it in place of the “null” in 
“BackupGroup”: null. 


e An example of a backup pool is shown on line 775 of the Template Character. 


“IconName™ 

“TokenCost~ 

“TokenCostLimited” 

“MinLeve lAppears”™ 

“MaxLeve lAppears”™ 

“Spawns InSmal 1¢ 

“Spawns InLargeCase” 

“PrimaryGroup” 
“Category” 
“Rarity” - 
“RequiredQuest” 
“Items ToSpawn™ 

‘inAmmoCapacity™ 

“MaxAmmoCapacity™ 
“NumMags Spawned 
“NumC lipsSpawned™ 
“NumRoundsSpawned™ 
“SpawnMagAndClip”: f 
“BespokeAttachmentChance” 
“IsCompatibleMagazine”: fa 
“AutoPopulateGroup”: fa 
“ForceSpawnAl lSubPools”: fa 
“IDOverr ide” 


Sizes”: [], 
“Actions” 
“Modes”: [J], 
“ExcludedModes” 
“FeedOptions”: [ | 
“MountsAvai lable” 
“RoundPowers”: [ | 
“Features”: [], 
“MeleeStyles”: [| 
“Me leeHandedness” 
“Mount Types” 
“PowerupTypes” 
“ThrownTypes”: [ | 
“ThrownDamageTlypes” 


“SubGroups”: | 


BackupGroup™ 
“Category™ 
“Rarity” y 
“RequiredQuest” 
“Items ToSpawn™ 
“MinAmmoCapac 
“MaxAmmoC apa 
“NusMagsSpawned™ 
“NumC lipsSpawned™ 


“NumRounds Spawned™ 


“SpawnMagAndc lip fal 
“BespokeAttachmentChance™ 
“IsCompatibleMag 
“AutoPopulateGroup™: fa 
“ForceSpawnAl lSubPools™: 
“IDOverride™” 


In this example, | have added two ModulMPX guns from the Modul-Sig mod. 
However, the player might not have Modul-Sig installed when they play my 
character, so I’ve created a backup group. 

For players that do not have Modul-Sig installed, they will instead receive either a 
vanilla UMP9 or a Scorpion Evo 3, which are kinda similar to an MPX. 

If | did not have this backup group, then a player without Modul-Sig installed 
would never see this equipment show up in their supply points at all! 
Alternatively, you could make Modul-Sig a dependency to your character, but 
then you are forcing the player to install more mods that they may not want. 
Keep in mind that the backup group will ONLY be used if the PrimaryGroup 
is COMPLETELY empty! 

o For example, if | had a vanilla MP5 in the PrimaryGroup alongside the 
MPXes then a player without Modul-Sig would ONLY receive an MP5 from 
the pool and could never get the UMP9 or Evo3 in the backup pool. 

Backup groups have the exact same settings and parameters as their 
PrimaryGroup counterparts. 

If you decide you don’t want the BackupGroup, you can always replace the entire 
pool (including the { }) with null, as shown in the other pools in the 
TemplateCharacter. 


Adding a New Pool 
1. Just copy the entire pool (everthing inside and including the { },) like so: 


2. Paste the pool between two other pools. (pools must always be separated by a 
comma) 


wm — Ctrl + V 


3. Modify the pasted pool as needed. 
4. This same method applies to subgroups, patrol groups, hold phases, etc. 
Anything contained in the { }. 


Mod Items 


e Mod items can spawn in TNH! 
e You can find the ItemID for a mod gun from your ObjectIDs.csv. 


Install the mod through r2mm. 
Run H3VR and go into the TNH Lobby. 
Make sure everything is done loading (no loading text above the leftmost 
panel). 

o Exit H3VR and go to H3VR/TNH_Tweaker to get your newly generated 
ObjectIDs.csv, which is explained in depth above. 

e Mod items will spawn anytime their tags match your pools just like vanilla items. 

o Correctly tagging the mod weapons is up to the mod creator. 

o However, if you catch something that doesn’t make sense, like getting a 
battle rifle in an SMG pool or something, you should reach out to the 
creator to let them know their tags are incorrect. 


Basic Equipment Pool Examples 


e This is just a couple examples of some basic equipment pools. Read 
through the Template Character to see more examples for backpack 
spawning, grapple hook spawning, health weenies, etc. 


Custom Icon and IDOverrides 


e This pool uses a custom ExampleSupplyPointlcon.png, which is an icon of a 
1911 that | made for John Wurst. 
The PNG is located in the TemplateCharacterSubfolder. 
This pool has “AutoPopulateGroup” set to false, which means ONLY the two 
IDOverride items can spawn. 

e The player will receive either the M1911 Tactical, or a vaulted M1911Modern that | 
put a suppressor on. 


e They will also receive a mag that is 0-7 rounds. Since the smallest mag available 
for a 1911 in game is 7, then that’s the size of mag the player will get. 


characterjson 


“Type” 
“IconName™ 


“TokenCost” 
“TokenCostlimited™ Custom supply point icon. 
“MinLeve lAppears” ; 
“MaxLeve lAppears” 
"Spawns InSmal lCase™ 
"“SpawnsInLargeCase™ 
“PrimaryGroup” 
“Category” 
“Rarity” 
“RequiredQuest” 
“Items ToSpawn” 
“MinAmmoCapacity” 
“MaxAmmoCapacity™ 
“NumMags Spawned” 
“Num lipsSpawned” 
“NumRounds Spawned” 
“SpawnMagAndC lip”: fa 
“BespokeAttachmentChance” 
“I sCompat ibleMagaz ine” e, 
“autoPopulateGroup”: false, Will NOT auto-populate the pool. 
“ForceSpawnAl 1SubPools” ‘ 
“I1DOverride”: | 


These 2 guns can 
spawn from this pool. 


“Ere 
“Sets” 
“€izes" 
“Actions” 
“Modes” 
“ExcludedModes” 
“FeedOptions” l. 
“Mount sAvai lable” 
“RoundPowers” ] 
“Features” 
“MeleeStyles” 

“Me leeHandedness”™ 
“MountTypes”: [] 


t 


“PowerupTypes” 


“ThrownTypes” 


“ThrownDamage Types” 
“SubGroups”™: [| 


“BackupGroup” 


Auto-Populated Pool + |IDOverride 
e Pools don’t have to be limited to just IDOverrides or Auto-population. You can 
actually use both at the same time! 
This example pool uses the same custom icon as before. 
The pool will auto-populate with any guns that are pocket or pistol sized, are real, 
are automatic, do NOT include fullauto, and have round powers of the pistol type. 
o This pool will auto-populate because AutoPopulateGroup is set to true. 


e The pool will have a bunch of low capacity pistols and will also have my vault 
M1911Modern that has a suppressor attached already. 


characterjson X 


“Type~ 
“IconName™ 
“TokenCost™ 


“TokenCostlimited”: 2, Custom supply point icon. 


“MinLeve lAppears” 


“MaxLeve lAppears” 
“SpawnsInSmallcase”: fal 
“SpawnsiInLargeCase”: fal 
“PrimaryGroup™ 
“Category™ 
“Rarity” 
“RequiredQuest™ 
“Items ToSpawn™ 
“MinAmmoCapac ity 
“MaxAmmoCapac ity” 
“NumMags Spawned” 
“Num lipsSpawned™ 
“NumRounds Spawned 
“SpawnMagAndc 
“BespokeAttachmentChance” 
“IsCompatibleMagazine™: fa 
tora : WILL auto-populate the pool. 
orceSpawnAl i 


“IDOverride” 


This vault gun gets added to 
the pool as well. 


“Modes” 
“Exc ludedModes” 


“FeedOptions” 
“Mount sAvailable’ 


“RoundPowers” 


“Features” 
“MeleeStyles” 

“Me leeHandedness~ 
“Mount Types” 
“Powerup Type 
“ThrownT ypes 
“ThrownDamage Types ~ 


“SubGroups~ 


“BackupGroup™ 


Attachment Pool 


e This pool spawns a reflex sight. 
e Sight must be able to attach to a Picatinny rail. 
e This pool uses the vanilla red dot icon. 


characterjson X 


te 


{ 


This option makes this pool appear as the 


middle (or third) icon on the supply point panel. 
“Type” 
“IconName” 


“TokenCost™ | 
“TokenCostLimited”: 2, Vanilla supply point icon. 
“MinLevelAppears”™ 


“MaxLeve lAppears” 
“SpawnsInSmallCase™: false, 
"“SpawnsInLargeCase”™: fa 
“PrimaryGroup” 


“category” ; Category limits the pool to 


ec ll attachments only, no firearms 
“Items ToSpawn” or other items. 


“MinAmmoCapac ity” 
“MaxAmmoCapacity™ 
“NumMags Spawned 

“NumC lipsSpawned™ 
“NumRounds Spawned” : 
“SpawnMagAndC lip”: fals: 


“BespokeAttachmentChance” 


“IsCompatibleMagazine™; false 
Tent eee oe VVILL auto-populate the pool. 
“ForceSpawnAl lSubPools”: fals 


“TDOverride” 
“Eras” 


“Sets” 


“Actions” 
“Modes” 


“ExcludedModes” , Pool will only contain 


puuecemaltaie attachments that are real, 
“RoundPowers”: [], are reflexes, and mount to 


“Features” picatinny rails. 


“Me leeStyles”™ 
“Me leeHandednesag 


“Mount Types” 


]» 

“PowerupTypes” iF 
“ThrownTypes”™: | 
“ThrownDamage Types” 


“SubGroups” 


“BackupGroup™: nu 


SubGroups 


e Subgroups are very powerful and very complicated! 


e |recommend avoiding these at first until you are comfortable with basic 
character development. 


How They Work 


A subgroup is a group of items nested inside another group. 
From the perspective of the PrimaryGroup, the subgroup is a single item. 
Ex: If the PrimaryGroup has 3 items, and the subgroup has 2 items, the odds of 
one of the 3 items spawning is 75% and the odds of the subgroup spawning is 
25%. If the subgroup is selected, then 1 of the 2 items in it would spawn. 

e If ForceSpawnAllSubPools is set to TRUE, then all subgroups that are one level 
down will spawn. 

o Ex: If set ForceSpawnAllSubPools to true on line 556, then | would get a 
gun from the PrimaryGroup with 3 mags, AND an M4A1 with 3 mags. 


e This is an example of a simple subgroup: 


cCharactersson xX 


“TokenCost” 
“TokenCostLimited” 
“MinLevelAppears” 
“MaxLeve lAppears” 
“SpawnsInSmallca 
“Spawns InLargeCase™ 


“PrimaryGroup” 


“Category” 


“Rarity” 
“RequiredQuest™ 
“Items ToSpawn™ 
“MinAmmoCapacity” 
“MaxAmmoCapacity™ 
“NumMags Spawned” 

“NurC lipsSpawned™ 
“NumRoundsSpawned™ 
“SpawnMagAndClip™: fal 
“BespokeAttachmentChance™ 
“IsCompatiblemMagazine™ 
“AutoPopulateGroup”: * 
“ForceSpawnAl lSubPools” 


“IDOverride” 


“Siz 

“Actions” 

“Modes”: [ 
“ExcludedModes™ 
“FeedOptions” 
“MountsAvailable” 
“RoundPowers” 
“Featur 7 
“MeleeStyles” 

“Me leeHandedness”™ 
“MountTypes” 
“PowerupTypes™ 
“ThrownTypes” 


e In this pool the odds that each of these guns is as follows: 


(2) 


oO 
oO 
oO 


Bren806: 25% 
H416: 25% 
M16A4: 25% 
Subgroup: 25% <- If subgroup spawns then 1 random item from the 
subgroup is chosen. 
mw M4A1v2Rightie: 12.5% 
mw M4A1v2Leftie: 12.5% 


e The point of this example subgroup is that | want both M4s to be able to spawn 
but | don’t want to get M4s more often than any other gun, so putting the M4s in 
the subgroup together keeps the odds of an M4 spawning the same as the other 
guns in the primary group. 

e Subgroups can be infinitely nested! This allows for some crazy powerful and 
unique use-cases. 


Subgroup Examples 


Spawning Some Guns with Different Mag Sizes 


This subgroup spawns with larger capacity 
mags than the primary group. 


e | want the Bubba’15 to be included in this pool along with the 3 other assault rifles 
above. 
e However, the Bubba15 is semi-auto only! So, in order to help balance it: 
o The full-auto assault rifles above spawn with 20-30 round mags. 
o The subgroup with the Bubba15 will spawn 30-60 round mags instead. 


Force Spawn a Subgroup 


Mag spawning turned off, 
because | want to manually 
spawn a specific magazine. 


ForceSpawnAllSubpools is set to TRUE, so if this 
SportACR subgroup spawns, then the 
MagazineH416D60 subgroup is forced to spawn too. 


This subgroup is set up to spawn 3 
items. However, there is only 1 item, so 
it will spawn that same item 3 times. 


This subgroup will ONLY be forced to 
spawn if it’s parent group (SportACR) 
spawns. le. if the Bren806, H416, or 
M16A4 spawn instead, then this drum 
mag will not spawn. 


A subgroup can be forced to spawn anytime its parent group is spawned. 

In this example, | don’t want that 60rnd casket mag to spawn, | specifically want 
the H416 60rnd drum to spawn. 

So, | have nested a subgroup that will soawn 3 MagazineH416D60. 

If the SportACR subgroup spawns, then it’s subgroup is also spawned because 
the SportACR subgroup has “ForceSpawnAllSubPools’” set to true. 


Levels 


e The Levels section of the character file dictates sosig spawns, hold encryptions, 
supply point settings, etc. 
o Levels defines the 5 holds for a 5-hold standard TNH run. 
o A 3-hold run will only use the first 3 levels. 
e Levels are actually pretty simple and straightforward to set up. 
e tis best to copy levels from a vanilla character 
(H3VR/TNH_Tweaker/DefaultCharacters) that is most similar to what you’re 
trying to accomplish. 


e This is an example of just 1 level of TNH. It includes all the settings for the first 
level of a TNH round. 


che 
characters 


Initial Level Settings 


{} characterjson X 


NumOverrideTokensForHold - Number of tokens player receives if they 
successfully complete the hold for this level. 
e Min/MaxSupplyPoints - A random number of supply points is chosen between 
these two values. 
o Inthe example above, exactly 1 supply point will spawn. 
e Min/MaxConstructors - Number of constructors that can appear in each supply 
room. 


o Constructors are the main panels that you can buy items from. 


*: 


o Vanilla maps have a max of 3 spots that constructors and panels can 
spawn, but some custom maps might only have 2 spots available, so if 
you had 4 MinConstructors, only 3 would actually show up. Keep this in 
mind when adding more than 1 constructor to a supply point. 

e Min/MaxPanels - Number of panels that can appear in each supply room. 

o Panels are the smaller tables where you can refill ammo, buy better mags, 
recycle guns, etc. 

o Constructors and panels share the same spots on a map. le. if you had 3 
panels and 1 constructor and a custom map only has 2 spots available, 
you'll only get 1 constructor and 1 panel. 

e Min/MaxBoxesSpawned - Number of boxes that can appear in each supply room. 

o Boxes are the breakable boxes that appear in supply rooms that contain 
either health drops or tokens. 


e) 
e Min/MaxTokensPerSupply - Number of tokens that can appear inside the boxes 
in each supply room. 
o These values do nothing if your Min/MaxBoxesSpawned is set to 0! 
e BoxTokenChance - The chance that a box has a token when broken. 
o * Up to the MaxTokensPerSupply room value. 
e BoxHealthChance - The chance that a box has a green diamond health drop 
when broken. 
e PossiblePanelTypes - The types of panels that can appear in supply rooms. 
o The possible panel types are: 
= AmmoReloader - Spawns rounds, clips, and refills mags that are 
placed on the panel. 


= MagDuplicator - Duplicates, upgrades, or provides a mag for the 
gun placed on the table. 


m Recycler - Turns 1 gun into 1 token. 
mw AddFullAuto - Adds full auto to a semi-auto gun. 


mu FireRateUp - Increases fire rate of the gun placed on the panel. 


mu FireRateDown - Decreases fire rate of the gun placed on the panel. 


TakeChallenge 


The TakeChallenge is settings for how hold points are defended. 
These are the sosigs/turrets that are defending the hold point before you arrive to 
start the hold. 


TurretType - The type of HamburgerTurret to spawn if NumTurrets is not 0. 
o Suppression - Launches flash bangs at the player. 
o Flamethrower - Throws flames. 
o SMG - Similar damage to an SMG sosiggun. 
o Machinegun - Similar damage to the sosiggun M60. 
o FLAK - Rocket launcher, good luck with one in an enclosed space... 
e EnemyType - The sosig defenders of the hold point. 


e NumtTurrets - Number of HamburgerTurrets to spawn (defined by TurretType 

above) 
NumGuards - Number of sosigs to spawn (sosig type defined by EnemyType) 
IFFUsed - IFF code for the defending sosigs. 

o Player is on IFF 0. 

o Sosigs on different IFFs will attack each other. 

o Ex: Sosig on IFF 0 is friend to player, Sosig on IFF 1 is enemy of player, 

Sosig on IFF 2 is enemy of player and of IFF 1 sosigs. 


HoldPhases 


e The HoldPhases defines the different phases of a hold. Multiple hold phases 
(everything between { }) can be added sequentially and separated with commas. 
e Each hold phase ends when all encryptions are destroyed or if the player fails to 
destroy the encryptions in time. 
“HoldPhases”: 
S 
“Encryptions”: [ 


|, 


“MinTargets”: 3, 


“MaxTargets": 5, 
“MinTargetsLimited”: 3, 
“MaxTargetsLimited”: 3, 
“EnemyType™: [ 


], 

“LeaderType”: 
“MinEnemies”: 2, 
“MaxEnemies”: 2, 
“MaxEnemiesAlive”: 4, 
“MaxDirections": 1, 
“SpawnCadence™: 20.0 
“ScanTime”: 30.0 
“WarmupTime": 7.0 
“IFFUsed": 1, 
“GrenadeChance": @.8, 
“GrenadeType” : 
“SwarmPlayer": false 


e Encryptions - The types of encryptions that spawn for this hold phase. 


You can add as many encryption types as you like, if you want to have a 
mix of encryptions instead of just one type (much more interesting for the 
player tbh) 
The encryption types are: 

ms Static 


| 


a Hardened 


= Swarm 


= Stealth 


a Agile 


m Regenerative 


Min/MaxTargets - Number of encryptions that spawn in this hold phase. 
Min/MaxTargetsLimited - Number of encryptions that spawn if the player is on 
Limited Ammo Mode. 
o These should be lower than the spawnlock target count. 
EnemyType - Enemy types that spawn during this hold phase (defined by 
Min/MaxEnemies). 
o Multiple enemy types can be added in by separating with commas. 
LeaderType - Leader type that spawns during this hold phase. 
o The leader is just another sosig that spawns with the group, but there is 
only ever 1 leader! 
Min/MaxEnemies - Number of enemies (defined by EnemyType) that spawn in 
each group or “wave”. 
MaxEnemiesAlive - Number of enemies that can be alive at once. 
o Ex: Inthe above example, once 4 enemies are spawned and still alive, no 
more enemies will spawn until the player kills some. 
MaxDirections - The max number of directions that a group or “wave” of sosigs 
can come from. 
o Ex: In this example, 2 sosigs will spawn each wave, and they will both 
come from the same place. 
o If max direction was 2, then sometimes these 2 sosigs would come from 
two different places, forcing the player to watch their back more. 
SpawnCadence - How frequently a new group/wave of sosigs spawn (in 
seconds). 
o Ex: In this example, a new wave spawns every 20 seconds. 
o Anew wave will NOT spawn if the MaxEnemiesAlive is currently maxed 
out. 
ScanTime - Time that passes before encryptions appear (in seconds). 


o Ex: In this example, encryptions will not appear until 30 seconds into the 
hold phase. 

WarmupTime - Time that passes before sosigs start spawning. 

o Ex: In this example, sosigs will not spawn for this hold phase until 7 
seconds has passed. 

Gives the player some breathing time between holds. 
For example, | increased this for R6 Steve to give the player time to setup 
claymores, traps, and gadgets. 
IFFUsed - The IFF used by the sosigs in this hold phase. 
GrenadeChance - The chance that a grenade gets automatically thrown into the 
room. 

o This is NOT the chance that a sosig has a grenade on them. This is a 
magic grenade that the game spawns in and yeets into the room through 
one of the entrances. 

o The grenade that is thrown is defined by GrenadeType 

o Anton does not use this in any of his characters. 

o Only 1 grenade of a single type can be spawned. 

GrenadeType - The type of grenade that is thrown into the room if 
GrenadeChance is not 0. 

o This is NOT the type of grenade that the sosigs will have with them. 
SwarmPlayer - If set to true, sosigs will head to the player’s location when they 
spawn. 

o They cannot track the player, they will start heading straight to the location 

the player was at when those sosigs spawned. 

o Their pathing can be interrupted if they get into a skirmish. 


SupplyChallenge 
e The SupplyChallenge is settings for how supply points are defended. 


e TurretType - The type of HamburgerTurret to spawn if NumTurrets is not 0. 
o Suppression - Launches flash bangs at the player. 
o Flamethrower - Throws flames. 
o SMG - Similar damage to an SMG sosigun. 
o Machinegun - Similar damage to the sosigun M60. 


o FLAK - Rocket launcher, good luck with one in an enclosed space... 
EnemyType - The sosig defenders of the supply point. 
NumTurrets - Number of HamburgerTurrets to spawn (defined by TurretType 


above) 


NumGuards - Number of sosigs to spawn (sosig type defined by EnemyType) 
IFFUsed - IFF code for the defending sosigs. 


oO 
10) 
12) 


Patrols 


Player is on IFF 0. 

Sosigs on different IFFs will attack each other. 

Ex: Sosig on IFF 0 is friend to player, Sosig on IFF 1 is enemy of player, 
Sosig on IFF 2 is enemy of player and of IFF 1 sosigs. 

Enemies generally are default IFF 1. 


e The Patrols section defines the settings of the sosig patrols that wander around 
the map between holds. 
e You can copy/paste a patrol (everything within and including the { }) and paste a 
second patrol below it, separated by a comma. 
o This allows you to have more varied patrols, and potentially patrols that 


fight each other if they are on different IFFs. 


EnemyType - The sosig type that predominantly forms this patrol. 
LeaderType - The patrol leader sosig type. 
o Each patrol only has 1 leader. 
e PatrolSize - Total number of sosigs that are in this patrol (includes the leader). 


MaxPatrols - Number of duplicate patrols that can be on the map at once. 
MaxPatrolsLimited - Number of duplicate patrols that can be on the map at once 
when the player is on Limited Ammo Mode. 
e PatrolCadence - Time before this patrol spawns another patrol (in seconds). 
o Ex: This patrol will spawn a new patrol every 90 seconds. 
e PatrolCadenceLimited - Time before this patrol spawns another patrol if the 
player is on Limited Ammo Mode (in seconds). 
e |FFUsed - The IFF of all the sosigs in this patrol. 
o Ex: If another patrol had an IFF of 2, they would fight each other if they ran 
into each other. 
e SwarmPlayer - If set to true, this patrol will head straight to the players location. 
o Sosigs canno track the player’s location. 
o The patrol heads to the location the player was at when the patrol 
spawned in. After which they patrol as normal. 
e AssualtSpeed - The speed at which this patrol moves through the map. 
oO Yes, it’s typo’d, no do not try to “fix” it. It’s a typo in TNHTweaker and 
“fixing” the type in your character file will break it. 
o AssualtSpeed options: 
a Walking 
m Running 
= Crawling 
mw Sneaking 
o The actual speed of each of these is defined inside the sosig files. 
e lsBoss - If set to true, then only 1 of these patrols can ever spawn and if killed will 
not respawn. 
e DropChance - Chance that this patrol will drop a green health diamond if you kill 
all of them. 
e DropsHealth - If set to true the patrol can drop health diamonds. If set to false 
they will never drop them. 


LevelsEndless 


e These levels define the Endless mode levels. 
o The first 5 levels in the “Levels” section are followed through first. 
o If the player is playing on Endless Mode, then after Hold 5 is 
complete, the Endless Levels will be selected from at random for 
each new hold. 
e Otherwise, Endless Levels are defined the exact same way as the initial 5 
Levels. 
e Reference the previous Levels section on how to set them up. 


Custom Sosigs 


e IMO, custom sosigs are one of the best ways to make a character stand out and 
feel unique! And they really don’t even take that much effort! 


Implementation 


1. Go to your TNHT Resources folder and open the DefaultSosigTemplates folder 
(which you copied in the ) 

2. Choose one of the sosig files that is similar to what you want to make and copy it 
to your TemplateCharacterSubfolder/sosigs folder. 


TemplateCharacter » TemplateCharacterSubfolder » sosigs 


Name Date modified 


by, | M_MercWiener_Riflewiener.json 1/22/2023 5:57 PM 


3. Rename the file to something new. Make sure to pick a unique name so as not to 
conflict with other character mods! 


TemplateCharacter » TemplateCharacterSubfolder » sosigs 


Name Date modified 


A SuperCoolRifleBoi.json /22/2023 5:57 PM 
4. Open the file and change the “SosigEnemyID” to match the name of your file. 


SuperCoolRifleBoijson X 


“DisplayName™: : 

"SosigEnemyCategory”: : Change this to match your file name. 
“SosigEnemyID": : This is what you'll use to spawn your 
“SosigPrefabs™: [ sosig in your character.json. 


] 


onfigs™: [ 


{ 


SuperCoolRifleBoijson X 


“DisplayName™: 
“SosigEnemyCategory”™ : 
“SosigEnemyID™ : 
“SosigPrefabs”: [ 


1], 


“Configs™: [ 


5. Then, in the “Levels” section of your character.json you can use the 
SuperCoolRifleBoi ID to spawn this sosig! 


6. Now you can go ahead and tweak this sosig however you like! Details on all the 
sosig settings are discussed below. 


Custom Sosig Modifications 


e Sosigs have a ton more settings than you might realize. Modifying these can 
really change the way sosig looks, the way it fights, and how difficult of an enemy 
it is. 

e Below | explain what all these settings do. 


Initial Settings 


SuperCoolRifleBoLjson X 


e DisplayName - This name shows up on the spectator panel and sosig spawner 
when selecting sosigs. 
e SosigEnemyCategory - This determines what category the sosig shows up in the 
spectator panel. 
o So, if you want to be able to view your custom sosig easily, make sure to 
change to a category that has less sosigs in it. 
o MercWieners is often what character creators use, so can get too crowded 
on the spectator panel and you won't be able to view them all. 
o IF YOU APPLY A CUSTOM SOSIG IN THE SPECTATOR PANEL AND 
THEN SUBSEQUENTLY REMOVE THAT CUSTOM SOSIG FILE IT WILL 
COMPLETELY BREAK H3 BOTH MODDED AND VANILLA 
VERSIONS!!! 
= Be sure to switch back to a vanilla sosig before you quit H3! 
e SosigEnemylD - This is the ID that you'll use in your character file to spawn this 
sosig. 
o highly recommend matching this to your file name (minus the .json) 
to keep things straightforward. 
e SosigPrefabs - This is the type of sosig body that is used. 
o Doesn’t actually affect any stats, just visual changes (except for 
junkbot body which has the weak spot on the back of the head). 
o Can be: 
= Sosigs 


e SosigBody_ Default 
o Standard hotdog colored body. 
SosigBody_BulkyArmor 
SosigBody_FireProof 
SosigBody_Pacification 
o Black body used by the rottweiler pacification squads. 
e SosigBody_Junkbot 
o Junkbots from Winter Wasteland. 
o Has weak point on back of head that if hit instantly 
kills it. 


e ZosigBody Boner 
ZosigBody_Floater 
ZosigBody_FunGuy 
ZosigBody_Grilled 
ZosigBody_GrilledAlt 
ZosigBody_Lemonhead 
ZosigBody LJ R 
ZosigBody_OldSmokey 
ZosigBody_Prick 
ZosigBody_Rot 
ZosigBody_Spurter 
ZosigBody_TheHung 


Configs 


e All of the settings under Configs take effect if the player set’s the Al mode to 
normal in the TNH lobby. 

e You should always set both Configs and ConfigsEasy for each sosig, and 
make sure that ConfigsEasy make for an easier sosig than the regular 


Configs. 
“Configs”: | 
{ 
“ViewDistance” 
“Hear ingDistance” 
“MaxFOv" 
"SearchextentsModifier” 
“DoesAggroOnFriendlyFire": fals« 
“HasABrain™: true, 
“DoesDropWeaponsOnBallistic”: true, 
“CanPickupRanged”™: true, 
“CanPickupMelee”: true, 
"CanPickupOther”: true, 
“TargetCapacity” 
“TargetTrackingTime” 
“NoFreshTargetT ime” 
“AssaultPointOverridesSkirmishPointwWhenFurther Than” 
“RunSpeed” : 
"“WalkSpeed” 
“SneakSpeed” 
“CrawlSpeed” 


“TurnSpeed” 


“MaxJointLimit” 
“MovementRotMagnitude” : 
“TotalMustard” 
“BleedDamageMult” 
“BleedRateMultiplier”: 
“BleedVFXIntensity”: 
“DamMult_Projectile” 
“DamMult_Explosive”: 
“DamMult_ Melee": 1 
“DamMult_Piercing”™: 
“DamMult_Blunt”: 
“DamMult_Cutting”: 
“DamMult_Thermal” 
“DamMult_Chilling”: 
"DamMult_EMP” 
“LinkDamageMultipliers” 
10 


ViewDistance - Distance in meters that the sosig can see enemies out to. 
HearingDistance - Distance in meters that sosigs can hear your gunshots. 
MaxFOV - The maximum Field of View of the sosig. This is the angle in degrees 
of their vision cone. 

SearchExtentsModified - Per Anton: This is a multiplier relative to the basic 
distance a sosig might search to pick up a gun if it doesn’t have one. It should 
almost always just be the default value. Raising it more will be explosively more 
performance expensive in certain contexts. 

DoesAggroOnFriendlyFire - If set to true, then a sosig that gets shot by a friend 
will start firing back on that friend. 

HasABrain - If you turn this to false, the sosig becomes a potato and won’t move 
or do anything at all. 


DoesDropWeaponsOnBallistic - If set to true, sosigs might drop their weapon if it 
is shot. 
CanPickupRanged - If set to true, sosig can pick up ranged weapons off the 
ground. 
CanPickupMelee - If set to true, sosig can pick up melee weapons off the ground. 
CanPickupOther - If set to true, sosig can pick up other weapons off the ground 
(such as grenades). 
TargetCapacity - | think this is the number of targets the sosig can keep track of 
at once. le. if set to 1 the sosig will focus on only one enemy at a time. 
TargetTrackingTime and NoFreshTargetTime - Per Anton: These have a super 
sensitive relationship to each other. | cannot advise on changing it other than 
not to. 
AssaultPointsOverridesSkirmishPointWhenFurtherThan - Distance in meters at 
which point the sosig will focus on it’s assault point instead of it’s current skirmish 
point. 

o | don’t fully understand how this works and advise against modifying 

it without proper testing. 

RunSpeed - Sosig’s speed when running. 
WalkSpeed - Sosig’s speed when walking. 
SneakSpeed - Sosig’s speed when sneaking. 
Crawl Speed - Sosig’s speed when crawling. 
TurnSpeed - How quickly the sosig can rotate. 
MaxJointLimit - The max deflection between 2 sosig segments. 
MovementRotMagnitude - Per Anton: how much the body itself rotates when the 
bot is moving. (like how rotwieners lean back more) 
TotalMustard - Amount of mustard a sosig has that can bleed out. 
BleedDamageMult - A multiplier that can be decreased or increased to change 
the amount of damage received from bleeding. 
BleedRateMultiplier - A multiplier that can be decreased or increased to change 
how quickly a sosig loses mustard. 
BleedVFXIntensity - Just the visual amount of mustard that comes out when a 
sosig is bleeding. 
DamMult_Projectile - Multiplier that modifies how much damage is received by 
bullets. 
DamMult_Explosive - Multiplier that modifies how much damage is received by 
explosives. 
DamMult_Melee - Multiplier that modifies how much damage is received by 
melee weapons in general. 
DamMult_Piercing - Multiplier that modifies how much damage is received by 
piercing melee weapons, specifically. 


DamMult_Blunt - Multiplier that modifies how much damage is received by blunt 
melee damage, specifically. 

DamMult_Cutting - Multiplier that modifies how much damage is received by 
cutting melee damage, specifically. 

DamMult_Thermal - Multiplier that modifies how much damage is received by 
being on fire. 

DamMult_Chilling - Multiplier that modifies how much damage is received by 
freezing? | don’t honestly know if any item in the game causes cold damage. 
DamMult_EMP - Multiplier that modifies how much damage is received by EMP 
weapons. 

LinkDamageMultipliers - Multiplier that modifies the damage received by each 
link. 

o For example, the head is usually a default of 10.0 and the torso is 2.0. 
This means that a headshot will multiply the amount of incoming damage 
by 10, and a torso shot only multiplies it by 2, so a headshot will do 5x the 
damage than a torso shot. 


SuperCoolRifleBoijson X 


“LinkStaggerMultipliers” 


“StartingLinkIntegrity” 


“StartingChanceBrokenJoint™ 


“ShudderThreshold” 
“ConfusionThreshold” 
“ConfusionMultiplier” 
“ConfusionTimeMax” 
“StunThreshold’ 
“StunMultiplier” 

“StunTimeMax” 

“CanBeGrabbed™ 

“CanBeSevered™ 

“CanBeStabbed™: ¢ 
“CanBeSurpressed™ 
“SuppressionMult” 
“DoesJointBreakKill Head” 
“DoesJointBreakKill Upper”: fa 
“DoesJointBreakKill Lower”: fal 
“DoesSeverkill Head”: ¢ 
“DoesSeverkill Upper” 
“DoesSeverkill Lower” 
“DoesExplodekill Head” 
“DoesExplodekill Upper” 


“DoesExplodeKkill Lower” 


o LinkStaggerMultipliers - Multiplier that modifies how much a shot to this 
link staggers the sosig. 
m Stagger is when a sosig gets dazed and temporarily doesn't fire 
back at you. 


o StartingLinkIntegrity - Starting integrity of the link, ie. how damaged it is 
when the sosig spawns. 
o StartingChanceBrokenJoint - Value between 0.0 and 1.0 that is the 
chance a link is broken when the sosig spawns. 
o ShudderThreshold - | don’t know what shudder is, but increasing this 
value will make it harder for a sosig to enter the shudder state. 
o ConfusionThreshold - Raising this number makes it harder for a sosig to 
enter the confusion state. 
m= Confusion is when a sosig has the question mark above them and 
kinda runs around confused temporarily. 
ConfusionMultiplier - Multiplier that scales the effect of the confusion state. 
ConfusionTimeMax - Maximum time in seconds that a sosig can be 
confused for. 
o StunThreshold - Raising this number makes it harder for a sosig to enter 
the stunned state. 
m Stun is when a sosig is blinded by a flashbang. 
StunMultiplier - Multiplier that scales the effect of the stun state. 
StunTimeMax - Maximum time in seconds that a sosig can be stunned for. 
CanBeGrabbed - If true then the sosig can be grabbed by the player. 
CanBeSevered - If true then the sosig links can be torn apart or sliced off. 
CanBeStabbed - If true then a sosig can have something stabbed into 
them that sticks in them. 
o CanBeSuppressed - If true a sosig can be suppressed. 
m= Suppression is when you shoot near a sosig (without hitting them) 
and it scares them into taking cover. 
SuppressionMult - Multiplier that scales the effect of the suppression state. 
DoesJointBreakkill_x - If set to true, then breaking this joint will kill the 
sosig. 
o DoesSeverkill_x - If set to true, then severing this link from the sosig will 
Kill it. 
o DoesExplodekill_x - If set to true, then if this link explodes (like hitting it 
with a large caliber, for example) the sosig will be killed. 


Ol SOL "Ox 1 © 


ConfigsEasy 


All of the settings under ConfigsEasy take effect if the player set’s the Al mode to 
easy in the TNH lobby. 

All of the settings under ConfigsEasy are the same as Configs. 

You should always set both Configs and ConfigsEasy for each sosig, and 
make sure that ConfigsEasy make for an easier sosig than the regular 


Configs. 


SuperCoolRifleBoijson x 


OutfigConfigs 


e This section defines what the sosig is wearing. 
e You can find all of the sosig clothing items in your ObjectIDs.csv by searching for 
“SosigAccessory”. 
o They don’t all contain “SosigAccessroy”, but they are all grouped together 
in the file. 


e Any clothing item can be equipped to any link of a sosig. 


SuperCoolRifleBoijson X 


“OutfitConfigs™: [ 
{ 


“Headwear” : 


“Chance Headwear”: 1.8, 
“ForceWearAllHead”: false, 
“Eyewear”: 
“Chance_Eyewear”™: bs 
“ForceWearAllEye”: false, 
“Facewear™: 


“Chance_Facewear™: 
“ForceWearAllFace”: false, 
“Torsowear™ : 


“Chance_Torsowear™ : 
“ForceWearAllTorso”: false, 
“Pantswear™: 


“Chance_Pantswear”™ : 
“ForceWearAllPants”: false, 
“Pantswear_Lower™: 

“Chance _Pantswear_Lower™: 0.0, 
“ForceWearAllPantsLower”: false, 
“Backpacks”: 


“Chance_Backpacks”™: 1.0, 
“ForceWearAllBackpacks”: false 
} 
], 


Headwear - The clothing options that can appear on the top link. 
Chance_Headwear - Chance that the sosig will have Headwear 

ole. if set to less than 1.0 then the sosig will sometimes have a hat and 

sometimes won't have any hat at all. 

o The Chance_x setting does the same thing for each type of clothing. 
ForceWearAllHead - Forces the sosig to have all of the headwears at once 
instead of just picking one of them. 

o The ForceWearAll setting does the same thing for each type of clothing. 
Eyewear - This is for goggles and glasses. 

Facewear - This is for gas masks, the welder mask, etc. 

Torsowear - This is for the torso link (the link right below the head). 
Pantswear - This is for the pants pants link (the link right below the torso link). 
Pantswear_Lower - This is for the lowest sosig link. 

Backpacks - This is for backpacks (duh). 


WeaponOptions 


e This section defines what weapons the sosig can spawn with. 
e You can find all of the sosig weapon options by searching for “Sosiggun’”, 
“SosigMelee”, or “Sosiggrenade” in your ObjectlDs.csv file. 


SuperCoolRifleBoijson X 


e WeaponOptions - These are the sosig’s primary weapons. 
o The sosig will only spawn with one of the options in this list. 
o Can be guns, melee, grenades, etc. 
e WeaponOptionsSecondary - These are the sosig’s secondary weapons. 
o Can be guns, melee, grenades, etc. 
e WeaponOptionsTertiary - These are the sosig’s tertiary weapons. 
o Can be guns, melee, grenades, etc. 
e SecondaryChance - The chance that the sosig spawns with a secondary 
weapon. 
o This example shows that every one of these sosigs will have a tanto. 
e TertiaryChance - The chance that the sosig spawns with a tertiary weapon. 
o This example shows that only 1 in 5 of these sosigs will have a frag 
grenade. 


Sosig Loot Pools 


e This section is at the very bottom of the sosig file and is where you wanna go if 
you want sosigs to drop loot when killed. 


SuperCoolRifleBotjson X 
C: > Users 3_Modding 
“DroppedLootChance™: @.8, 
“DroppedObjectPool”: { 

“Category”: 
“Rarity”: @ 
“RequiredQuest” : 
“Items ToSpawn”™ : 
“MinAmmoCapacity”™: 
“MaxAmmoCapacity”™: 
“NumMagsSpawned™ : 
“NumClipsSpawned” : 
“NumRoundsSpawned” : 
“SpawnMagAndClip”: false, 
“BespokeAttachmentChance” : 
“IsCompatibleMagazine”: false, 
“AutoPopulateGroup”™: false, 
“ForceSpawnAllSubPools”: false, 
“IDOverride”: [], 
“Eras”: [], 
"Seats: (i, 
er. ee Ee 
“Actions”: [], 
“Modes”: [], 
“ExcludedModes”: [], 
“FeedOptions™: [], 
“MountsAvailable”: [], 
“RoundPowers”: [], 
“Features”: [], 
“MeleeStyles”: [], 
“MeleeHandedness”™: [], 
“MountTypes”: [], 
“PowerupTypes”: null, 
“ThrownTypes™: [], 
“ThrownDamageTypes™: [], 
“SubGroups”: [] 


e DroppedLootChance - The chance that this sosig drops loot when killed. 
e DroppedObjectPool - Defines the possible loot that can spawn from the sosig. 
o You set loot up the exact same way as the EquipmentPools in the 
Character.json file. How to do that is explained in the 
above. 

You can use subgroups as well! 
You cannot define backup pools, unfortunately. 
Gun pools will NOT spawn with mags! The “NumMagsSpawned”, 
“NumClipsSpawned”, and “NumRoundsSpawned” will not do 
anything! 


m In order to workaround this, you can simply put mags at a subgroup 
to your gun pool and force the subgroup to spawn. How to set this 
up is explained in the SubGroups section above. 


Vault Guns 


e So, you want to have some wacky (or tame) vault gun spawn in your character? 
Well this is very easy to do! 


Implementation 


1. Boot up H3VR and go straight to a scene that contains the old spawner (Do not 
go into the TNH lobby yet!), | recommend the Proving Grounds. 
Create your abemination lovely and tasteful vault gun. 
Save the bastardteveehid work of art into the old item spawner’s vault. 
Enter the TNH Lobby, which triggers TNHT to regenerate its reference files. 
Exit H3VR. 
Go to H3VR/TNH_Tweaker/VaultFiles 
Copy the vault file(s) you want from here into your 
TemplateCharacter/TemplateCharacterSubfolder/vault. 
a. Your vault guns are gonna have some crazy names. Exihibit A: 


a 


AKMTactical_2019-10-04T15_15_45.9234382-07_00_0_DONTREMOVETHISPARTOFFILENAMEV02a.txtjson 


b. It can be hard to figure out which gun is which, so it’s best to keep a clean 
vault on the old spawner. 

i. |The date of creation of the vault file is located in the name after the 
ItemlD, for example, this vault file was created back in October of 
2019. 

ii. | You can also open up the files in VSCode and see what 
attachments are on it to help identify which one is which. 

8. Rename your vault file to something sane such as: 


TemplateCharacter » TemplateCharacterSubfolder » vault 


Name Date modified 


FY SuperAwesomelacticalAK.json 1/15/2023 8:14 PM 


9. Open up your file in VSCode and make sure to use the same name to replace 
the FileName entry inside the file: 


SuperAwesomeTacticalAKjson X 


Rename this to match the file name (minus the .json): 
“FileName”: “SuperAwesomeTacticalAK”, 


SuperAwesometacticalAKjson X 


a. The FileName entry and the actual filename.json don’t have to match, but 
it is much less confusing if they do! 

b. Make sure you use a unique vault name! If you named your vault gun 
“vault_P90”, that’s a bad idea, because if another character creator 
made a vault file with the same name they would conflict! 

c. When you put this vault file in your character, you must use the 
“FileName” entry inside the character as the ItemID for this vault 
gun. 

i. This is why it’s just easiest if they match. 


10. Add the “FileName” to an equipment pool: 


f 
: 


“Type” 
“IconName~ 


“TokenCost™ 


“MinLevelAppears™ 
“Maxleve lAppears™ 
“Spawns InSaal lCase” 
“SpawnsInLargeCase” 
“Pr imaryGroup~ 
“Category 
“Rarity” 
“RequiredQuest™ 
“Items ToSpawn™ 


“MinAmsmoCapacity~ 


“BespokeAttachmentChance” 


“IsCompat ibleMagaz ine” 


“AutoP 
“Force 


“1DOverr 


“actions” 
“modes” 
“Exc ludedModes 
“FeedOpt 


“Mount sAvi 


“Feature 
“MeleeStyles” 


“Me leeHandedness” 


“ThrownDamageTypes~ 
“SubGroups™ 


a. Now my Super Cool vault file will be included inside this assault rifle pool 
alongside the H416 and M16A4! 


Vault Gun Modifications 
e But WAIT! There’s MORE! 


e You can actually modify some core settings of the vault guns and make them act 
completely differently! 
e Below | explain all the settings available to you: 


o FileName - Basically the “ItemID” of this vault file. 


m You'll match this to your file name for convenience and use it in 
your equipment pools to spawn this gun. 
LoadedRoundsInMag - List of all rounds in the magazine. 
= Donot modify this by hand. Re-make the vault file instead. 
SavedFlags - | don’t know what this does tbh, don’t touch it. 
OverrideFireRate - If set to true, then the custom SpeedRearward, 
SpeedForward, and SpringStiffness values in the file will be used to 
override the gun’s fire rate. 

m You can speed up or slow down fire rates. 

u It’s best to use the LSIIC panel to test the fire rate and it allows 
you to modify these values on the fly to tune the gun to the fire 
rate you want. 

m Doubling the Speed does NOT necessarily mean a doubling of fire 
rate. These 3 values have a very delicate relationship. 

SpeedRearward - Speed of bolt as it travels rearward. 

SpeedForward - Speed of bolt as it travels forward. 

SprintStiffness - Value of stiffness of bolt spring. Higher values means 
slower bolt travel. 

OverrideFireSelectors - If set to true, then the custom FireSelectorModes 
will be used instead of the gun’s default settings. 

FireSelectorModes - Used to modify fire modes on a gun. 

m As many fire modes can be added as you like by copy/pasting 
everything inside of and including the { }. 

m You may also delete whatever modes you like! 

Example: | want a character that only has civilian-legal guns, | 
simply make vault files of the bare guns with no attachments or 
mags, and then set OverrideFireSelectors to true and delete the 
FullAuto and Burst modes. 

SelectorPosition - Position of the fire selector for this mode. 

m Some guns have rotating selectors, some have translating 
selectors. 

m It’s best to keep your values for this inside the min/max that is 
there by default. 

m= For example, on the gun above if | wanted to add a burst option, | 
would probably change my selector positions to be 0, 6, 12, 18 so 
they are evenly spaced and the selector won't like, go off the gun or 
something silly. 


o ModeType - Type of fire mode. 


m Safe 
m Single 


= Burst 
m FullAuto 
o BurstAmount - Number of rounds to fire if this fire mode is set to Burst. 
u This value only gets used if the ModeType directly above it is 
set to Burst. 
m= Brb, adding a 99rnd burst to a vault gun... 
o Components - All the attachments on the gun. 
= |donot recommend trying to modify these. 
m Just re-make the gun in the vault if you need to change something. 


Building and Testing 


Building Your Deli File 


e When you are ready to try out your new character, you must zip the sub-folder an 
manifest into a zip file and change the .zip to a .deli. 


odding TNH Tweaker TemplateCharacter 


Name Date modified Type 


be, | TernplateCharacterSubfolder 1/7/2023 7:46 AM File folder 
FV manifest.json 1/13/2023 3:29 PM JSON File 
} Open with Code 

1-Zip 

CRC SHA 

Edit with Notepad++ 


Scan with Microsoft Defender... 


Give access to 


WinMerge 


Send to ?| ® Bluetooth device 

i Compressed (zipped) folder 
MA Desktop (create shortcut) 
B Documents 

& Fax recipient 

BB Mail recipient 

WinSCP (for upload 


Cut 
Copy 
Create shortcut 


Delete 


Rename . 


e 1. Select both your subfolder and manifest.json. 
e 2. Right click -> Send to -> Compressed (zipped) folder. 


e 3. Rename the zip folder to the name of your character, and change the .zip 
extension to .deli. 


odding » TNHIweaker » TemplateCharacter 


Name Date modified 


7h TemplateCharacterSubfolder 


| manifest.json 1/13/2023 3:29 PM 
#4! TemplateCharacter.zip 1/13/2023 3:43 PM 
Hding » TNHIweaker » TemplateCharacter 
Name Date modified 
7h lemplateCharacterSubfolder 1/7/2023 7:46 AM 
A manifest.json 1/13/2023 3:29 PM 
| TemplateCharacter.deli 1/13/2023 3:43 PM 
e 4. You will receive a popup warning you about changing the file extension. Just 
click “yes”. 


A If you change a file name extension, the file might become unusable. 


Are you sure you want to change it? 


dding TNHIweaker » TemplateCharacter 
Name 


7h TemplateCharacterSubfolder 


y, | manifest.json 


| TemplateCharacter.deli 


Loading Your Character Into H3 


e The fastest way to test your character is to simply make a new folder inside your 
r2mm profile folder and drop the deli file in. 


e 1. Find your H3 profile folder from r2mm. R2mm -> settings -> Locations -> 
Browse profile folder 


G8 r2modman (3.1.35) - Testing = 


© Start modded 


® Start vanilla 


Ba Installed 
Search: 


Pp : 
= Online 


All Profile } Debugging Modpacks Other 


[# Config editor Browse data folder 
Open the directory where mods are stored for all games and profiles. 
® Settings ee ME sane? 


e Help 
Browse profile folder 
Open the folder where mods are stored for the current profile. 


e 2. In the file explorer window that opens, navigate to BepInEx -> plugins. 


r2modmanPlus-local H3VR > profiles » Testing BepinEx plugins 


Name Date modified Type 


M Andrew_FTW-FTW_Arms_12Gau_Additions g 8:11 PM File folder 
By Andrew _FTW-FTW_Arms_AFCL / File folder 


BE Arpy-PuppyScripts 9/23/20 0 PN File folder 


e 3. Create a new folder called YourName-CharacterName and drop your .deli file 
into that folder. 

o This folder can technically be named whatever you want. 

o After you release on Thunderstore, make sure to delete this test 
folder from BepInEx -> plugins or it will conflict with your TS version 
if you download it! 

e 4. Verify this r2mm H3 profile has TNHTweaker installed before starting the 
game! 

e 5. Start modded from r2mm, go to the TNH lobby and see if your character 
shows up in the proper character group. 

o Keep in mind that there is currently a 12 character maximum per group. | 
recommend using a clean “testing” profile in r2mm with just the essential 
framework mods (like TNHT) to avoid conflicts when initially testing. 

o If your character does not show up, then check your Bepinex error logs 
(r2mm -> settings -> Debugging -> Copy log file contents to clipboard) and 
proceed to the Troubleshooting section below. 


Testing 


e Ifyou are just testing the weapon spawns, you might want to enable unlimited 
tokens in the TNHT config. 
- 


Debug 


© Start modded 


® Start vanilla EnableUnlimitedTokens 


If true, you will spawn with 999999 tokens for any character in TNH (useful for testing loot pools) 
Setting type: Boolean 
Bs Installed Default value: false 


= Online 
true 


[# Config editor EnableDebugText 

eee If true, some text will appear in TNH maps showing additional info 

2 Settings i 
: Setting type: Boolean 


@ Help Default value: false 
F 


o You will probably want to set this to false if you are trying to test the 
balance of your character’s tokens/economy. 

e You should try to play through your character at least several times before you 
release it on Thunderstore in order to spot any bugs and/or balance issues. 

o You can always throw your .deli into a gallery on Homebrew2 Discord 
server to see if others can help test as well. 

e You should also go to your H3VR -> TNH_Tweaker -> 
GeneratedEquipmentPools folder after you first successfully load your character 
in H3. 

o A file with your character’s name will appear here. 

o This file contains every single item that was added to every single 
equipment pool in your character.json file. 

o This is a very quick and easy way to see if your pools are generated 
properly and if any guns/items are missing. 

e Make sure you test the various modes that players can use. 

o Test on Endless mode. 
o Test on Limited ammo mode. 


Troubleshooting 


Checking if Your Character Loads 


e Always go to the TNH lobby and check if your character shows up. 


e Just because you get an error in the log doesn’t mean the character won’t show 
up! 


Bepinex Log Errors 


e lf your character doesn’t load or you have other issues, always check your 
Bepinex log first! 

e You can either watch the log while H3 loads, or even better, go to R2MM -> 
Settings -> Debugging -> Copy Log File Contents and paste into VS Code. 

e Then search through the log for your character’s name to see what errors show 
up. 

e Usually TNHT does a very good job of explaining what the problem is in the error 
logs. 

o For example, read through the entire error because usually it will tell 
you exactly which line of your character.json file is causing the 
problem. 

o The “Line” is the line of your character.json indicated in VSCode as so: 


o The “Position” is the number of characters (including spaces) counted 
from the leftmost side of the line. 


Example Errors 


Missing Manifest 


o 


e Either the manifest.json file is not present, or it’s in the incorrect location. 
e Check the file structure section above to verify your files and folders are set up 
correctly. 


Incorrect Paths 
[Warning: Deli] Asset glob from [Template Character 0.0.0] of type 


hn3vr.tnhtweaker.deli:character did not match any handles: 
TemplateCharacter/ 
e This means that Deli could not find the character file in the location you specified in your 
manifest. 


Ensure all the paths and subfolder name match in your manifest.json. 
Reference this section for more info on correct manifest path setup. 


Thunderstore Release 


e So you've tested your character extensively, you like how it plays, and you’re 
ready to unleash your mod on the masses! It’s time for a Thunderstore (TS) 
release. 


Versioning 


e First, make sure you have the version number properly set in your character’s 
Deli manifest. 


bdding >» TNHIweaker » TemplateCharacter 


Name 


7h TemplateCharacterSubfolder 


| manifest.json 


manifestjson X 


Users ? 


e Those 3 version digits do have meaning! 

o You should follow the SemVer standard for choosing version numbers. 
o Given a version number MAJOR.MINOR.PATCH, increment the: 

m MAJOR version when you make incompatible changes. 

m MINOR version when you add functionality in a backwards 

compatible manner. 

m PATCH version when you make backwards compatible bug fixes. 

o Your initial release should be 1.0.0. 


Creating Your Thunderstore Package 


1. Download this example TS package, unzip it in a different location than your 
character folder. 


iding ThunderstoreZips » YourName-TemplateCharacter 


Name ’ Date modifie 


> | icon.png 
A manifestjson 
FY README.md 


2. Create an icon.png and replace the example one. 
a. This png MUST be 256x256 pixels! This is a TS requirement. 
b. The easiest thing is to take your character’s thumb.png and resize it to 
256x256. 
3. Setup your TS manifest.json (this is a totally different manifest than the one you 
made earlier for your character!) 


manifestjson X 


» = 1. Change to your character name. No spaces or special characters! 
‘eee 2. Match version number to your Deli manifest version number. 


3. Change description. This is what people will see on r2mm 
ee 4. Make sure you have TNHT as a dependency! 


a. Whenever you update your character, you MUST update the version 
number! TS will no allow you to upload the same mod again with the 
same version number. 

b. The description is very important as for most people it will be the first and 
only description they see. This description shows up in r2mm. 

c. Dependencies are mods that are forced to install when your character is 
installed. TNHT is a requirement, obviously, but let’s say your character 
relies on ModulAR for a bunch of vault guns, for example, then you would 
add the ModulAR dependency string like so: 


i. | Dependency strings can be found on the mod’s TS page. 


Thunderstore Communities» Browse Upload Developers~ & Join our Discord 


Packages / Meat_banono 


Meats ModulAR 


Build an AR! 


By 


Last updated 2 weeks ago 

Total downloads 107999 

Total rating 23 »& 

Categories Weapons 

Dependency string Meat_banono-Meats_ModulAR-3.1.7 


Dependants 


4. Update your TS README.md 


# Template Character 


Description and details of your character. 
What maps was it designed for? 
How does it play like? 


Was the character designed for spawnlock, limited ammo, or both? 


# Changelog 


## [ 2023-xx-xx 


* Initial Release 


a. The ReadMe is written in markdown. 


i. | You can add bullets, headers, links, etc with markdown. 
b. Add details about your character, link to optional mods, etc. 
c. Date the changelog. 
i. | You don't have to maintain a changelog, but it is very good practice 
to do so. 


ii. | Personally, | really appreciate a changelog because it tells me if the 
mod has some cool new stuff that | want to try out right away! 
iii. If you are updating your mod, add a new changelog entry 
(don’t delete previous ones) and explain what things were 
added, changed, or fixed from the last version. 
5. Update the version number in your character’s manifest.json. 


bdding » TNHIweaker >» TemplateCharacter 


Name 


7h lemplateCharacterSubfolder 


A manifest.json 


manifestjson X 


Bs 


6. Zip up your character into a .deli file_ Follow the steps in the Building section 
above. 


iding » TNHIweaker >» TemplateCharacter 


Name Date modified 


7h TemplateCharacterSubfolder 
| manifest.json 


| TemplateCharacter.deli 


7. Copy/Paste your character’s .deli file into the example TS package you 
downloaded in step 1. 


ding ThunderstoreZips » YourName-TemplateCharacter 


Name Date modifi 


> | icon.png 

| manifest.json 

A README.md 

| TemplateCharacter.deli 


8. Select all 4 of the above files and zip them together. Right click -> Send To -> 
Compressed (zipped) folder. 


odding ThunderstoreZips YourName-TemplateCharacter 


Name ate modified Type 


¥j icon.png /14/2023 8:08 AM PNG File 
A manifest.json /14/2023 9:38 AM JSON File 
A README.md /14/2023 8:47 AM MD File 
FY TemplateCharacter.deli 1/14/2023 9:08 AM DELI File 
~) Open with Code 

7-Zip 

CRC SHA 

Edit with Notepad++ 

Scan with Microsoft Defender... 

Share 


Give access to 


Send to ‘ Bluetooth device 
Cut Compressed (zipped) folder 


Copy Desktop (create shortcut) 


Documents 
Create shortcut 
| Fax recipient 
Delete 
Mail recipient 


WinSCP (for upload) 


Rename 


9. This zip file is your TS Package! 


Hiding » ThunderstoreZips » YourName-TemplateCharacter 


Name Date modified 


| icon.png 1/14/ :08 AM 


| manifest.json 
A README.md 
4 TemplateCharacter.deli {14/2023 M 
az) YourName-TemplateCharacter.zip 1/14/2023 9:50 AM 


Uploading to Thunderstore 
1. Go to hit 


2. Login with GitHub or Discord. 


Thunderstore Communities» Browse Developersy & Join our Discord Q Login with GitHub Login with Discord 


All mods 


Last updated Newest Most downloaded Top rated 


® Pinned 


3. Now the Upload button is available. Click it. 


Thunderstore Communities» Browse Upload Developers~ GJ Join our Discord sirpotatos Settings Logout 


All mods 


Last updated Newest Most downloaded Top rated 


4. Drag and drop your TS package (zip file) into the box. 


ae coe oa 


Thunderstore Communities Browse Upload Developers ~ 


Upload packag TS has some very helpful preview 
and checking tools here. | 
i A re recommend checking them out! 


« New upload handler 


¢ Uploading a large file? Check your package manifest ft 


Submit Package 


Choose or drag file here 


Select your Team (will just be your username). 

Make sure Communities ONLY has H3VR in it. 

Select your Categories as “Characters”. 

Click Submit! 

Bask in the glory of your first custom character release! 


